Realizar transferencias
Este producto le permitirá a los comercios realizar transferencias bancarias en línea a través de llamados al API
post
https://api.payvalida.com/cashout/v1/transfer
Producción
post
https://api-test.payvalida.com/cashout/v1/transfer
Sandbox
Request
Request (ejemplo)
Response
Response (ejemplo)
Campo | Tipo de dato | Requerido | Descripción |
---|---|---|---|
merchant | String | Sí | Identificación del comercio que realiza la operación, (50 caracteres). |
operation | String | Sí | Identificador de la operación generada por el comercio. Debe ser identificador único, (40 caracteres). |
checksum | String | Sí | SHA512(merchant+operation+FIXED_HASH) (512 caracteres) |
beneficiary | JSON | Sí | Información específica del beneficiario (JSON) |
identification | String | Sí | Número de identificación del beneficiario (20 caracteres) |
identificationType | String | Sí | Tipo de identificación provisto, pueden ser los siguientes valores:
- CC: Cédula de Ciudadanía
- CE: Cédula de Extranjería
- PS: Pasaporte
- TI: Tarjeta de Identificación |
name | String | Sí | Nombre del beneficiario, no soporta caracteres especiales (50 caracteres) |
lastname | String | Sí | Apellido del beneficiario, no soporta caracteres especiales (50 caracteres) |
email | String | Sí | Dirección de correo electrónico válida. |
country | String | Sí | Actualmente solo soporta Colombia, valor esperado "CO" |
bankAccount | String | Sí | Nombre del banco en donde tiene su cuenta el beneficiario, se permiten los siguientes valores:
- Bancos en Colombia |
bankAccountNumber | String | Sí | Número de cuenta del beneficiario. |
bankAccountType | String | Sí | Tipo de cuenta, se permiten los siguientes valores:
- Ahorro
- Corriente |
transactionValue | Float | Sí | Valor a transferir, este valor será debitado de la billetera del comercio |
{
"merchant": "merchantName",
"operation": "opId1234",
"checksum": "5807c366db37aff0330cb0fc520149e45024f9224d035e0d420f153b69b2effc514204a0d4e7aba629343c6890e7642db6c4ef0249ef4bc855590846f948c083",
"beneficiary": {
"identification": "43750860",
"name": "James Arthur",
"lastname": "Hammett Green",
"email": "[email protected]",
"country": "CO",
"bankAccount": "BANCO DE OCCIDENTE",
"bankAccountNumber": "123456789",
"bankAccountType": "Corriente",
"identificationType": "CC",
"transactionValue": 2301.00
}
Campo | Tipo de dato | Descripción |
---|---|---|
CODE | String | Indica el código del resultado, “0000” indica resultado sin error, otro valor indica el código del error. |
DESC | String | Contiene el mensaje referente al code enviado. |
DATA | String | Indica si la transacción se envío con éxito (para resultados sin error) |
{
"CODE": "0000",
"DESC": "OK",
"DATA": "Transfer sent successfully"
}
Nota: Toda operación registrada, queda en estado EN PROCESO. Una vez que el banco responda a la solicitud de transferencia el estado será actualizado.
Para poder utilizar este servicio, el comercio debe tener configurada al menos una red comercial de tipo Transferencias Bancarias.
Last modified 3mo ago