Return an inbound Transfer
Automatically return a transfer based on your business logic.
Only available in Mexico
Fintoc lets you return an inbound transfer up to 90 days after the original transfer using the return transfer endpoint. This is useful when you want to return transfers based on your own business logic—for example, if you expect a specific amount but receive a different one.
Trigger the return
Using the transfer_id
and the Fintoc-JWS-Signaturefor the request, call the return endpoint:
cURL
curl --request POST \
--url https://api.fintoc.com/v2/transfers/tr_2wlt3xRBaEstTGPezqIGXy6JUU8/return \
--header 'Authorization: sk_test_9c8d8CeyBTx1VcJzuDgpm4H' \
--header 'Fintoc-JWS-Signature: CNMaYaDGU3ZhFV1ve6p3sAdYXhEklej8DVIAMqIWCkpNmT6Jp7iigcndXwH5q3WQFHiswgIQU5-_-4rV3jKGptCROmEyWPW8_elhYH1apzAyjOjyZ55ygv37xKHzIFhixzAwmXlAv4pfD4lVelYWVNOSN7REA0QJeCy2vKdqZ5cjqCXQ1lkQUlzOE7dpuNoAkhAhAJJ8HaamFKy7Gl7uwmqbIr-dVYv21d_9O7mO26n0gy3zWXD2nJDxU5Mzl2pZd8-sFvUr9Kmp_YkeRMh4bSe0fr1Uc_YgkjpmYUyu7kaxRWTbAdJ3GwqWFMUDiyfhHdzvZPZyU4VkWreimoydMA' \
--header 'accept: application/json' \
--header 'content-type: application/json'
If successful, the returned object will have return_pending
status. Once the return is processed, the status will change to returned
.
Using the SDK
transfer = client.v2.transfers.return(
transfer_id = "tr_2wlt3xRBaEstTGPezqIGXy6JUU8"
)
Handling the result of a returned transfer
In most cases, calling the transfer return endpoint should work seamlessly. If an exceptional case occurs that prevents the transfer from being returned, we’ll notify you through a special webhook:
✅ If the return is successful:
- The transfer status becomes
returned
- You'll receive an
inbound.transfer.returned
webhook - The
receipt_url
shows the original Comprobante Electrónico de Pago (CEP) with the status "Devuelta"
❌ If the return fails:
- The transfer status reverts to
succeeded
- You'll receive an
inbound.transfer.return_failed
webhook
See our test guide to simulate both scenarios so you can handle the result in your integration correctly.
Updated 6 days ago