API Cashout Redes
v.1.0.0 Español
Search
⌃K

Registro

Registra una transacción de cashout, permitiendo la entrega del dinero al solicitante
Método: POST
Producción: https://api.payvalida.com/cashout/v1/transaction/{netname}
Sandbox (pruebas): https://api-test.payvalida.com/cashout/v1/transaction/{netname}
Request
Request (ejemplo)
Response
Response (ejemplo)
Nombre
Requerido
Descripción
Tipo
Longitud
idoperation
Si
Identificador de la operación (obtenida de la consulta)
Numérico
15
netcode
Si
Código de la red (convenio)
Numérico
20
transaction
Si
Número único de la transacción
Alfanumérico
50
teller
Si
Código del punto físico que ejecuta la operación
Alfanumérico
40
danecode
Si
Código DANE **
Alfanumérico
50
checksum
Si
Cadena de comprobación, calculada con SHA512(name + idoperation + transaction + FIXED_HASH)
Alfanumérico
512
curl -i -X POST -H "Content-Type:application/json" -d '{
"idoperation": 1393,
"transaction": "99999999901",
"netcode": 1052,
"teller": "150",
"checksum": "e38aef6c8a604f62c05336457fd0c262b73a5a3028cd414309fea4b1f519f05ccfe9e29b6e21fbf5e9c02999a98003960c71dd89818021ac27faa83da1ce7169"
}' https://api-test.payvalida.com/cashout/v1/transactions/redEjemplo
Nombre
Descripción
Tipo
code
Indica el código del resultado, “0000” indica resultado sin error, otro valor indica el código del error
Alfanumérico
text
Contiene el mensaje referente al code enviado.
Alfanumérico
data
Contiene los datos de la transacción (para resultados sin error)
Objeto
data-amount
Monto de la transacción (Dado que no se permiten retiros parciales, al registrar la transacción se confirma el monto de la operación)
Alfanumérico
data-transactionCost
Indica el costo que asume el usuario por realizar la transacción
Alfanumérico
data-currency
Moneda en la que está registrada la orden de cashout (Debe coincidir con el data-currency enviado en la consulta)
Alfanumérico
data-description
Descripción de la transacción
Alfanumérico
data-document
Confirmación del número de documento
Alfanumérico
data-otp
Confirmación del otp enviado
Alfanumérico
data-idpayvalida
identificador de la transacción en Payvalida
Alfanumérico
data-transaction
Confirmación del transaction enviado por la red
Alfanumérico
data-checksum
Cadena de comprobación, calculada con SHA512(transaction + idpayvalida + FIXED_HASH)
Alfanumérico
{
"code":"0000",
“text”:”OK”,
"data":{
"amount":"45000.0",
“transactionCost”:”2000.0”,
"currency":"COP”,
"description":"Retiro dividendos",
"document":"986157352",
“otp”:”1234”,
“idpayvalida”:”998563”,
“checksum”: ”wff88nfd99e52b735c67df2c1945b68w4r34wf4t989jc0pl...”
}
}
** Para integraciones por fuera de Colombia, se requiere enviar el zipcode en el campo danecode
Last modified 7mo ago