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.

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

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)

Next - Notificación

Notificación

Last modified 3mo ago