Transferencia

Hacer un retiro en Ecuador por medio de transferencia bancaria consiste en capturar los datos necesarios de la persona que recibirá el pago y hacer una solicitud a través de nuestra API con un Bearer Token y una secretKey. De esta forma, las transacciones se autentican y se realizan de forma segura.

¿Cómo funciona?

Transferencia es una forma de retirar fondos en Ecuador mediante transferencias bancarias. Para completar una transacción utilizando este método de retiro, el cliente debe seleccionar la opción "Transferencia Bancaria", ingresar su número de cuenta bancaria, seleccionar el banco, el tipo de cuenta, y confirmar la operación.

El proceso de payout con transferencia en Ecuador consta de cuatro etapas principales:

1. Selección de método. El cliente elige retirar dinero por medio de transferencia en tu sitio web o aplicación.
2. Ingreso de datos. El cliente ingresa los datos necesarios para que el retiro sea realizado (como banco, número y tipo de cuenta) y confirma la transacción.
3. Validación y Captura. ProntoPaga valida la información del retiro, hace la solicitud de transferencia al banco y mueve el dinero desde la cuenta del comercio hacia la cuenta del cliente.
4. Confirmación. El cliente recibe una confirmación de retiro exitoso en su correo electrónico. A su vez, tu comercio recibe la confirmación a través de los webhooks que hayas configurado.

Lista de bancos

La lista de códigos bancarios para pay outs de tipo transferencia la puedes encontrar en este artículo, dividida por países. El código bancario debe enviarse en el campo bankCode del endpoint de creación de un retiro.

Crea un nuevo retiro

Para hacer una solicitud de nuevo retiro a través de nuestra API deberás usar este endpoint. La solicitud se envía con tu Bearer Token, así como con tu secretKey.

Además, debes incluir los datos necesarios del cliente al que le mandarás el dinero, como: nombre, apellido, correo electrónico, teléfono, ID, cuenta, entre otros.

Body de la solicitud

A continuación puedes ver un ejemplo del body que se envía en la solicitud:

{
  "amount": "25.90",
  "document_id": "12345678912",
  "beneficiaryName": "John",
  "beneficiaryLastName": "Doe",
  "beneficiaryEmail": "[email protected]",
  "beneficiaryPhone": "999999999",
  "accountNumber": "10070010030000",
  "accountType": "AHO",
  "accountType_id": "P",
  "bankCode": "10",
  "data": "XYZ789",
  "confirmationURL": "https://www.webhook.com",
  "currency": "USD",
  "country": "EC",
  "sign": "Signature of the parameters"
}

Respuesta

Como respuesta a una solicitud de pago exitosa, recibirás un identificador del retiro en el sistema, el estado del retiro y datos adicionales de la transacción.

Confirmación de un retiro

Una vez que hayas completado el proceso, ProntoPaga devolverá los datos de la transacción a la URL que especificaste en confirmationURL.

Para confirmar si una transacción fue exitosa, debes verificar que en tu webhook el valor del campo status sea success.

Conoce todos los estados posibles de un retiro en el siguiente enlace: Estados de los pay outs.

Prueba tu integración

Contamos con un catálogo de datos de prueba que puedes usar para comprobar que tu integración está lista, así como para ver el flujo de pago que seguirá tu cliente. Además, también puedes hacer pruebas con nuestros demos.

Certifica tu integración

La certificación de la integración en sandbox es un paso obligatorio que todos los comercios deben realizar antes de recibir sus credenciales de producción. Su propósito es asegurar que la integración cumpla con los estándares técnicos, funcionales y de seguridad requeridos por ProntoPaga. Dentro de esta sección, se establecen los requisitos que deben cumplirse sin excepción para que la certificación sea aprobada.

Requisitos de certificación

A continuación, encontrarás los distintos requisitos necesarios para completar tu certificación: