Cancel a refund
Cancels a refund by its id. Only refunds in pending status can be canceled; once Fintoc starts disbursing the funds, the refund cannot be canceled.
v1 · Base URL https://api.fintoc.com/v1
Authorizations
Path Parameters
The id of the refund to cancel.
Response
Refund canceled. The returned refund has canceled status.
A refund returns funds from a succeeded payment to the payer. Fintoc disburses refunds asynchronously, so a refund moves through pending, in_progress, and succeeded, or ends in failed or canceled. The amount and currency are denominated in the smallest unit of the refunded resource's currency.
Unique identifier of the refund.
"ref_8XzNbCv1LqKjWp4R"
Type of the object. Always refund.
Amount refunded, as an integer in the smallest unit of currency (for example, 5000 for $5000 CLP, since CLP has no minor unit).
5000
ISO 8601 timestamp of when the refund was created.
"2026-03-04T17:04:10Z"
Three-letter ISO 4217 currency code. Always matches the currency of the refunded resource.
CLP, MXN "CLP"
Reason why the refund failed. One of fraud_risk (the disbursement was blocked by Fintoc's fraud checks) or insufficient_funds (your organization did not have enough funds to cover the refund). null unless the refund failed.
Set of key-value pairs attached to the refund when it was created.
Mode of the object. live objects use real institution data, test objects use fake data for integration testing.
test, live "live"
Bank account that receives the refunded funds. null for refunds that are not disbursed by bank transfer (for example, card refunds).
ID of the refunded resource.
"pi_jsperFI9bnyM2RTo"
Type of the refunded resource. Always payment_intent.
payment_intent "payment_intent"
Current status of the refund. One of pending (the disbursement has not started), in_progress (Fintoc is disbursing the funds), succeeded (the funds reached the recipient account), failed (the disbursement failed; see failure_code), or canceled (the refund was canceled before disbursing).
pending, in_progress, succeeded, failed, canceled "succeeded"
ISO 8601 timestamp of when the refund was last updated.
"2026-03-04T17:04:10Z"