capabilities.work

Payment Refund And Track

A 3-step recipe with Interswitch. We can help you get access.

Recipe · 3 steps

Payment Refund And Track

Confirm a payment, raise a refund, and track the refund to a terminal state.

  1. Read the original payment to confirm it succeeded before refunding.
  2. Raise a refund against the confirmed payment. A 201 indicates the refund was created and entered its lifecycle.
  3. Re-read the refund to observe its status. Branches when the refund reaches a terminal SUCCESS / COMPLETE / FAILED state.
What you'll need to have ready
  • accessToken: Bearer access token from the Passport OAuth token endpoint.
  • paymentId: Id of the original successful payment to refund.
  • refundReference: Unique refund identifier.
  • refundType: PARTIAL or FULL refund type.
  • refundAmount: Refund amount in minor units (required for PARTIAL).
  • reason: Optional reason for the refund.
For your developer

Arazzo workflow interswitch:refund-and-track, 3 operations: $sourceDescriptions.paymentsApi.getPayment → $sourceDescriptions.refundsApi.createRefund → $sourceDescriptions.refundsApi.getRefund. Specs on APIs.io.