Realizar transferencias

Este producto le permitirá a los comercios realizar transferencias bancarias en línea a través de llamados al API

Producción

POST https://api.payvalida.com/cashout/v1/transfer

Sandbox

POST https://api-test.payvalida.com/cashout/v1/transfer

Request

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) (128 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: Colombia: - CC: Cédula de Ciudadanía - CE: Cédula de Extranjería - PS: Pasaporte - TI: Tarjeta de Identificación - NIT: Número de Identificación Tributaria Ecuador: - CC: Cédula de identidad - RUC: Registro único de contribuyentes El Salvador: - DUI - DNI - PS - CE - SRL - NIT Guatemala: - DPI: Documento personal de identificación Perú: - DNI: Documento nacional de identidad - CE: Cédula de Extranjería
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í	Valores permitidos: CO: Transferencias en Colombia EC: Transferencias en Ecuador GT: Transferencias en Guatemala PE: Transferencias en Perú SV: Transferencias en El Salvador
bankAccount	String	Sí	Nombre del banco en donde tiene su cuenta el beneficiario, se permiten los siguientes valores: Bancos en Colombia Bancos en Ecuador Bancos en El Salvador Bancos en Guatemala Bancos en Perú
bankAccountNumber	String	Sí	Número de cuenta del beneficiario. Perú: número de cuenta local. Consultar bancos que trabajan con cuneta local. Para perú si se envía cuenta CCI, este campo es opcional.
bankAccountNumberCci	String	No	Perú: número de cuenta CCI, usado para transferencias interbancarias. (20 caracteres). Consultar bancos que trabajan con cuenta CCI. Para Perú si se envía cuenta CCI, bankAccountNumber es opcional.
bankAccountType	String	Sí	Tipo de cuenta, se permiten los siguientes valores: Colombia - Ahorro - Corriente Ecuador - Ahorro - Corriente El Salvador - Ahorro - Corriente Guatemala - Ahorro - Monetaria Perú - Ahorro - Corriente
transactionValue	Float	Sí	Valor a transferir, este valor será debitado de la billetera del comercio

Request (ejemplo)

{
    "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
    }

Request Perú (ejemplo)

{
    "merchant": "merchantName",
    "operation": "opId1234",
    "checksum": "5807c366db37aff0330cb0fc520149e45024f9224d035e0d420f153b69b2effc514204a0d4e7aba629343c6890e7642db6c4ef0249ef4bc855590846f948c083",
    "beneficiary": {
        "identification": "43750860",
        "name": "James Arthur",
        "lastname": "Hammett Green",
        "email": "[email protected]",
        "country": "PE",
        "bankAccount": "BCP",
        "bankAccountNumber": "84320000036204819572",
        "bankAccountNumberCci": "84320000036204819572",
        "bankAccountType": "Corriente",
        "identificationType": "CC",
        "transactionValue": 2301.00
    }

Response

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)

Response (ejemplo)

{
    "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.