API Payouts
Search
⌃K

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
Identificación del comercio que realiza la operación, (50 caracteres).
operation
String
Identificador de la operación generada por el comercio. Debe ser identificador único, (40 caracteres).
checksum
String
SHA512(merchant+operation+FIXED_HASH) (512 caracteres)
beneficiary
JSON
Información específica del beneficiario (JSON)
identification
String
Número de identificación del beneficiario (20 caracteres)
identificationType
String
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
Nombre del beneficiario, no soporta caracteres especiales (50 caracteres)
lastname
String
Apellido del beneficiario, no soporta caracteres especiales (50 caracteres)
email
String
Dirección de correo electrónico válida.
country
String
Actualmente solo soporta Colombia, valor esperado "CO"
bankAccount
String
Nombre del banco en donde tiene su cuenta el beneficiario, se permiten los siguientes valores: - Bancos en Colombia
bankAccountNumber
String
Número de cuenta del beneficiario.
bankAccountType
String
Tipo de cuenta, se permiten los siguientes valores: - Ahorro - Corriente
transactionValue
Float
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.