Recharge funds

This API allows merchants to request an URL in order to make a payment that will recharge funds

Recharge funds

POST https://api.payvalida.com/cashout/v1/rechargecashout

URL Sandbox: https://api-test.payvalida.com/v1/rechargecashout

This API registers a payment order and it returns the checkout parameter, this is an URL to be used by the merchant in order to complete the payment. Once the merchant make the payment and this will be approved, the merchant will receive a confirmation e-mail about the recharging

Request Body

Name	Type	Description
merchant	string	Merchant ID provided by Payvalida (max. 50 characters)
language	string	Message language. (max. 2 characters)
email	string	Payer e-mail. (max. 100 characters).
country	number	Country code. (max. 3 characters) Note: Currently only 343 is available
order	string	Unique ID for the generated order (max. 100 characteres)
money	string	ISO currency code. (max. 3 characters). Note: Currently only COP is available.
amount	number	Order amount.
description	string	Order description. (max. 250 characters)
checksum	string	Checksum encoded in SHA512 (email+country+order+money+amount+FIXED_HASH)
user_di	string	Payer document ID (max. 15 characters)
user_type_di	string	Buyer document type (max. 3 characters)
user_name	string	Buyer name (max. 25 characters)

200 Returns a JSON following this structure:

{
   "CODE": "0000",
   "DESC": "OK", 
   "DATA":{
      "OrdenID":"comercioExterno_9892",
      "Monto":"500000",
      "PVordenID":"98555221",
      "Referencia":"8766554",
      "Operacion":"CREADA",
      "checkout":"checkout.payvalida.com/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJNRVJDSEFOVF9DRUwiOiIzMTc2ODI3MzQxIiwiT1JERVJfTUVUSE9EIjoiZWZlY3R5IiwiTUVSQ0hBTlRfQ09ERSI6MjU0LCJNRVJDSEFOVF9FTUFJTCI6ImhyZXN0cmVwb0BwYXl2YWxpZGEuY29tIiwiaXNzIjoiYXV0aDAiLCJNRVJDSEFOVF9MT0dPIjoiaHR0cHM6Ly9zMy5hbWF6b25hd3MuY29tL3ZhbGlkZGF3ZWIvZXZlbnRvcy9mZW5hbGNvYnJhLnBuZyIsIk1FUkNIQU5UX1VSTF9SRVRVUk4iOiJ3d3cucGludmFsaWRkYS5jb20uY28iLCJNRVJDSEFOVF9OQU1FIjoiSGVybmFuIFJwbyAoQ09MKSIsIk9SREVSX0JSSUVGIjoiVGVzdCBSRVNUZnVsbCBQdXJjaGFzZSBPcmRlciBQT1NUIiwiTUVSQ0hBTlRfVEVMIjoiMjg4MDUzOSIsIk9SREVSX0NVUlJFTkNZIjoiQ09QIiwiT1JERVJfQU1PVVQiOiIxMCwwMDAuMDAiLCJleHAiOjE1MzA0MDE1MzgsIk9SREVSX1JFRkVSRU5DRSI6IjQyMzEzIn0.QVsZwm-2BIkK-5RgrAX2NuwGqmHSNHD_zw91i1hcSc8”
   }
}

Be aware this service is available only for Colombia (country code = 343 and currency code = "COP"). The merchant ID (merchant) and FIXED_HASH are generated when the merchant sign up in our platform and this is sent by e-mail.