Developer docs

Payment statuses

Every payment link has a status. Read it by fetching the payment link.

StatusMeaning
CREATEDThe payment link exists and is waiting for the customer to pay.
SUCCESSThe customer paid successfully. The payment is eligible for settlement.
FAILEDThe payment attempt failed. The link cannot be reused, so create a new one.
REFUNDEDA successful payment was refunded by our team before it was included in a settlement.
DISPUTEDThe customer raised a chargeback and it is under review.
CHARGED_BACKA dispute was decided against you, or you accepted it.

Lifecycle

CREATED ──► SUCCESS ──► REFUNDED
   │           │
   │           └──► DISPUTED ──► SUCCESS        (you won)
   │                        └──► CHARGED_BACK   (you lost, or accepted)
   └──► FAILED

Notes

  • Only SUCCESS payments can be refunded or disputed.
  • A payment that is already part of a settlement can no longer be refunded. Refunds are processed by our team, and there is no refund API yet.
  • A payment can have at most one chargeback. See Chargebacks.
  • Statuses are read by polling the fetch endpoint. There are no webhooks yet.