Devolver una transferencia

Solo disponible en México

Fintoc te permite devolver una transferencia entrante hasta 90 días después de la transferencia original usando el endpoint return transfer. Esto es útil cuando quieres devolver transferencias según tu propia lógica de negocio—por ejemplo, si esperas un monto específico pero recibes uno distinto.

Iniciar la devolución

Usando el transfer_id y la firma Fintoc-JWS-Signature para la solicitud, llama al endpoint de devolución:

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"
}
'

Si tiene éxito, el objeto devuelto será un objeto transfer con estado return_pending. Una vez procesada la devolución, el estado cambiará a returned.

Usando el SDK

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

Manejar el resultado de una transferencia devuelta

Debes manejar los siguientes eventos de webhook al manejar devoluciones de transferencias:

Evento	Descripción
`transfer.inbound.returned`	La transferencia se devolvió exitosamente. El `receipt_url` muestra el Comprobante Electrónico de Pago (CEP) original con el estado “Devuelta”.
`transfer.inbound.return_failed`	La transferencia no pudo ser devuelta y volverá al estado original: succeeded.

Consulta nuestra guía de pruebas para simular ambos escenarios y poder manejar el resultado correctamente en tu integración.

Inicio

Recursos

Pagos

Transferencias

Domiciliación bancaria

Movimientos

Devolver una transferencia

Solo disponible en México

Iniciar la devolución

cURL

Usando el SDK

Manejar el resultado de una transferencia devuelta

​Solo disponible en México

​Iniciar la devolución

​cURL

​Usando el SDK

​Manejar el resultado de una transferencia devuelta

Solo disponible en México

Iniciar la devolución

cURL

Usando el SDK

Manejar el resultado de una transferencia devuelta