Register
Last updated
Last updated
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}
| Name | Required | Description | Type | Length |
|---|---|---|---|---|
** If your integration is outside Colombia, you have to send the zip code in the parameter danecode
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
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