Return an inbound transfer

Only available in Mexico

Fintoc lets you return an inbound transfer up to 90 days after the original transfer. Call the return endpoint based on your business logic. For example, return a transfer when you expect a specific amount but receive a different one.

Trigger the return

Use the transfer_id and a JSON Web Signature (JWS) in the Fintoc-JWS-Signature header to call the return endpoint:

cURL

curl --request POST \
     --url https://api.fintoc.com/v2/transfers/return \
     --header 'Authorization: sk_test_9c8d8CeyBTx1VcJzuDgpm4H-bywJCeSx' \
     --header 'Fintoc-JWS-Signature: CNMaYaDGU3ZhFV1ve6p3sAdYXhEklej8DVIAMqIWCkpNmT6Jp7iigcndXwH5q3WQFHiswgIQU5-_-4rV3jKGptCROmEyWPW8_elhYH1apzAyjOjyZ55ygv37xKHzIFhixzAwmXlAv4pfD4lVelYWVNOSN7REA0QJeCy2vKdqZ5cjqCXQ1lkQUlzOE7dpuNoAkhAhAJJ8HaamFKy7Gl7uwmqbIr-dVYv21d_9O7mO26n0gy3zWXD2nJDxU5Mzl2pZd8-sFvUr9Kmp_YkeRMh4bSe0fr1Uc_YgkjpmYUyu7kaxRWTbAdJ3GwqWFMUDiyfhHdzvZPZyU4VkWreimoydMA' \
     --header 'Idempotency-Key: 1ebfd86c-a75b-4606-872f-9f1cdd9724ca' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "transfer_id": "tr_Kasf91034gj1AD"
}
'

The endpoint returns a transfer with the return_pending status. After Fintoc processes the return, the status changes to returned.

Using the SDK

transfer = client.v2.transfers.return(
  transfer_id = "tr_2wlt3xRBaEstTGPezqIGXy6JUU8"
)

Handle the return result

Handle these webhook events for transfer returns:

Event	Description
`transfer.inbound.returned`	Fintoc returned the transfer. The `receipt_url` shows the original Comprobante Electrónico de Pago (CEP) with the `Devuelta` status.
`transfer.inbound.return_failed`	The return failed. The transfer returns to its original `succeeded` status.

Use the test guide to simulate both outcomes and verify that your integration handles each one.

Receiving transfers Add logic to CLABEs

⌘I

Home

Resources

Payments

Transfers

Direct debit

Movements

Return an inbound transfer

Only available in Mexico

Trigger the return

cURL

Using the SDK

Handle the return result

​Only available in Mexico

​Trigger the return

​cURL

​Using the SDK

​Handle the return result

Only available in Mexico

Trigger the return

cURL

Using the SDK

Handle the return result