Transactions

Work with the Transaction lifecycle using available APIs.

Initialize (Available)


final transaction = await MindPaystack.instance.transaction.initialize(
  InitializeTransactionOptions(
    amount: Money.fromCents(250000, Currency.ngn), // ₦2,500.00
    email: 'buyer@example.com',
    reference: 'order_123',
    metadata: {'orderId': '123'},
    channels: [TransactionChannel.card, TransactionChannel.bank],
  ),
);

Verify (Available)


final verification = await MindPaystack.instance.transaction.verify(
  VerifyTransactionOptions(reference: transaction.data.reference),
);

List Transactions (Available)


final list = await MindPaystack.instance.transaction.list(
  ListTransactionsOptions(
    status: TransactionStatus.success,
    page: 1,
    perPage: 20,
  ),
);

Fetch Single Transaction (Available)


final transaction = await MindPaystack.instance.transaction.fetch(
  FetchTransactionOptions(idOrReference: 'ref_or_id'),
);

Transaction Totals (Available)


final totals = await MindPaystack.instance.transaction.totals(
  TransactionTotalsOptions(),
);

Transaction Timeline (Available)


final timeline = await MindPaystack.instance.transaction.viewTimeline(
  ViewTransactionTimelineOptions(idOrReference: transaction.data.reference),
);

Export Transactions (Available)


final export = await MindPaystack.instance.transaction.export(
  ExportTransactionsOptions(
    status: TransactionStatus.success,
    format: ExportFormat.csv,
  ),
);

Charge Authorization (Available)


final charge = await MindPaystack.instance.transaction.chargeAuthorization(
  ChargeAuthorizationOptions(
    authorizationCode: 'AUTH_XXXX',
    email: 'customer@example.com',
    amount: Money.fromCents(50000, Currency.ngn),
  ),
);

Partial Debit (Available)


final debit = await MindPaystack.instance.transaction.partialDebit(
  PartialDebitOptions(
    authorizationCode: 'AUTH_XXXX',
    email: 'customer@example.com',
    amount: Money.fromCents(25000, Currency.ngn),
    currency: Currency.ngn,
  ),
);