curl --request POST \
--url https://api.fintoc.com/v1/refunds \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"amount": 5000,
"metadata": {
"order_id": "9182"
}
}
'{
"id": "ref_8XzNbCv1LqKjWp4R",
"object": "refund",
"amount": 5000,
"created_at": "2026-03-04T17:04:10Z",
"currency": "CLP",
"failure_code": null,
"metadata": {
"order_id": "9182"
},
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"holder_name": "Jane Doe",
"institution_id": "cl_banco_de_chile",
"number": "123456789",
"type": "checking_account"
},
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"status": "pending",
"updated_at": "2026-03-04T17:04:10Z"
}Create a refund
Creates a refund for a succeeded payment in the live or test mode of the API key used. The refund starts in pending status and Fintoc disburses the funds asynchronously. Omit amount to refund the resource in full, or pass a lower value for a partial refund. Payments with a split support only full refunds. Each split recipient funds the original allocation. The recipient that pays the payment processing fee also pays the refund fee. If any recipient has insufficient balance, the refund remains pending for a later attempt. The sum of all refunds for a resource cannot exceed the resource’s amount.
curl --request POST \
--url https://api.fintoc.com/v1/refunds \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"amount": 5000,
"metadata": {
"order_id": "9182"
}
}
'{
"id": "ref_8XzNbCv1LqKjWp4R",
"object": "refund",
"amount": 5000,
"created_at": "2026-03-04T17:04:10Z",
"currency": "CLP",
"failure_code": null,
"metadata": {
"order_id": "9182"
},
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"holder_name": "Jane Doe",
"institution_id": "cl_banco_de_chile",
"number": "123456789",
"type": "checking_account"
},
"resource_id": "pi_jsperFI9bnyM2RTo",
"resource_type": "payment_intent",
"status": "pending",
"updated_at": "2026-03-04T17:04:10Z"
}Cuerpo
Respuesta
Refund created. The refund starts in pending status and the funds are disbursed asynchronously.
A refund returns funds from a succeeded payment to the payer. Fintoc disburses refunds asynchronously. Refund outcomes are succeeded, failed, canceled, or returned. Before disbursement completes, a refund is pending or in_progress. In Mexico, a refund can move from succeeded to the terminal status returned if the bank returns the transfer. The amount and currency are denominated in the smallest unit of the refunded resource's currency.
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), returned (the bank transfer was returned after succeeding), failed (the disbursement failed; see failure_code), or canceled (the refund was canceled before disbursing).
pending, in_progress, succeeded, returned, failed, canceled "succeeded"
¿Esta página le ayudó?