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. Llama al endpoint de devolución según tu lógica de negocio. Por ejemplo, devuelve una transferencia cuando esperas un monto específico pero recibes uno distinto.

Iniciar la devolución

Usa el transfer_id y una firma JWS (JSON Web Signature) en el encabezado Fintoc-JWS-Signature para llamar 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`	Fintoc devolvió la transferencia. El `receipt_url` muestra el Comprobante Electrónico de Pago (CEP) original con el estado `Devuelta`.
`transfer.inbound.return_failed`	La devolución falló. La transferencia vuelve a su estado original, `succeeded`.

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

Recibir transferencias Agregar lógica a las CLABEs

⌘I

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