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 cuenta local. 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)

Request Perú (ejemplo)

Response

Response (ejemplo)

Usar números de cuenta en formato real (aunque sean de prueba). Formatos inventados provocan errores en la transferencia.

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, se debe coordinar con su gerente comercial la activación.