Register

Register a cashout transaction, handing cash to the requester.

Method: POST

Production: https://api.payvalida.com/cashout/v1/transaction/{netname}

Sandbox: https://api-test.payvalida.com/cashout/v1/transaction/{netname}

Request

Name	Required	Description	Type	Length
idoperation	Yes	Operation identifier (obtained from the query)	Numeric	15
netcode	Yes	Network code	Numeric	20
transaction	Yes	Transaction ID (unique)	Alphanumeric	50
teller	Yes	ID of the teller that executed the transaction	Alphanumeric	40
danecode	Yes	DANE code **	Alphanumeric	50
checksum	Yes	Checksum encoded with SHA512(name + idoperation + transaction + FIXED_HASH)	Alphanumeric	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	Indicates the resulting code, “0000” means result with no error, any other value indicates the error code.	Alphanumeric
text	Contains the detailed message associated with the code.	Alphanumeric
data	Contains the transaction’s data (when there’s no error)	Object
data-amount	Amount of the transaction (since partial amounts are not allowed, when registering the transaction its amount is confirmed).	Alphanumeric
data-transactionCost	Cost assumed by the user for this transaction	Alphanumeric
data-currency	Currency registered for this cashout order	Alphanumeric
data-description	Description of the transaction	Alphanumeric
data-document	Confirmation of the document ID	Alphanumeric
data-otp	Confirmation of the OTP sent	Alphanumeric
data-idpayvalida	Transaction identifier in Payvalida’s system	Alphanumeric
data-transaction	Transaction confirmation as reported by the network	Alphanumeric
data-checksum	Checksum encoded with SHA512(transaction + idpayvalida + FIXED_HASH)	Alphanumeric

Response (example)

{

"code":"0000",

“text”:”OK”,

"data":{

"amount":"45000.0",

“transactionCost”:”2000.0”,

"currency":"COP”,

"description":"Retiro dividendos",

"document":"986157352",

“otp”:”1234”,

“idpayvalida”:”998563”,

“checksum”: ”wff88nfd99e52b735c67df2c1945b68w4r34wf4t989jc0pl...”

}

}

** If your integration is outside Colombia, you have to send the zip code in the parameter danecode