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

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

Request (ejemplo)

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

Response

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

Response (ejemplo)

{

"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