API Cashout Redes
v.1.0.0 Español
v.1.0.0 Español
  • Introducción
  • Consulta
  • Registro
  • Reverso
  • Manejo de excepciones
    • Errores
Powered by GitBook
On this page

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}

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 en Colombia. Para integraciones por fuera de Colombia se requiere enviar el código postal (zipcode)

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...”

}

}

PreviousConsultaNextReverso

Last updated 9 months ago