Registrar operación
Registrar Operación
POST
https://api.payvalida.com/cashout/v1/operation
URL Sandbox: https://api-test.payvalida.com/cashout/v1/
operation
Registra una operación de cashout que permite la entrega de dinero al solicitante
Request Body
merchant*
string
Identificación del comercio que realiza la operación, (30 caracteres).
checksum*
string
SHA512(merchant+operation+amount+currency+ document+FIXED_HASH) (512 caracteres).
operation*
string
Identificador de la operación generada por el comercio. Debe ser identificador único, (40 caracteres).
amount*
number
Valor de la operación, (20 caracteres) *En Perú solo debe contener un digito decimal.
currency*
string
Código ISO de la divisa de la operación, (3 caracteres)
description*
string
Descripción de la operación, (50 caracteres)
document*
string
Número del documento de identidad del usuario final que realiza la operación, (20 caracteres)
otpLength
number
Longitud de la clave OTP (default 4, 4 <= otpLength <=12) (entre 4 a 12 caracteres)
expire
string
Fecha de expiración de la operación (YYYY-MM-DD) default 30 días, (8 caracteres).
transactionCost
number
Monto que el comercio cobrará al cliente por la operación (default 0) (10 caracteres).
beneficiaryName
String
Nombre de la persona que recibirá el dinero *Obligatorio para retiros en Guatemala y Perú.
beneficiaryLastName
String
Apellido de la persona que recibirá el dinero *Obligatorio para retiros en Peru.
beneficiaryDocumentType
String
Tipo de documento en Perú (DNI,RUC,CE) *Obligatorio para retiros en Perú.
String
Email de usuario. *Obligatorio para retiros en Perú.
cellphone
String
Numero de celular de usuario. *Obligatorio para retiros en Perú.
Información de la respuesta
code: indica el código del resultado, “0000” indica resultado sin error, otro valor indica el código del error
text: contiene el mensaje referente al code enviado.
data: contiene los datos de la transacción (para resultados sin error)
amount: valor de la transacción
transactionCost: indica el costo que asume el usuario por realizar la transacción
currency: moneda en la que está registrada la operación de cashout
description: descripción de la operación
document: número de documento de identidad
otp: OTP generada para la operación (si se indica true, en el parámetro SMS, este valor no se proporciona)
operation: identificador de la operación, generado por el comercio
expire: fecha de expiración de la operación
payvalidaCode: identificador de la operación en Payvalida
balance: monto disponible en la bolsa
NOTA: el parámetro CURRENCY solo admite moneda local (correspondiente al país de registro del comercio). Si se recibe un currency diferente retornara un error.
Toda operación registrada, queda en estado PENDIENTE.
El campo "expire" indica la fecha en la cual no se podrán realizar los retiros, es decir que para esa fecha las Redes de Desembolso no entregarán el dinero.
Last updated