Recarga bolsa

Este API permite a los comercios solicitar un URL para efectuar un pago que recargue su bolsa de desembolsos.

Tener en cuenta que actualmente el país y la moneda habilitado es Colombia (343) y Pesos ("COP") respectivamente.

El listado de excepciones de esta funcionalidad se encuentran en la documentación de Recaudos.

La identificación del comercio (merchant) y FIXED_HASH, es generada al momento de crear una cuenta en nuestra plataforma y se envía por correo electrónico.

Para recargas a través de esta API se tiene los siguientes límites máximos:

• Persona natural: 26.000.000 COP

• Persona jurídica: 1.500.000.000 COP

Recargar

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

URL Sandbox: https://api-test.payvalida.com/cashout/v1/rechargecashout Este API registra una orden de pago y retorna el parámetro checkout, el cual indica la URL en la cual el comercio deberá completar el pago. Una vez el comercio realice el pago y este sea aprobado, llegará una notificación por correo electrónico indicando la recarga de la bolsa. El correo deberá ser enviado a Payvalida para su configuración.

Request Body

Name	Type	Description
merchant	string	Identificación de comercio Payvalida. Max 50 carecteres
email	string	Correo electrónico del pagador. Máx 100 caracteres
country	number	Código de país. Máx 3 caracteres. Actualmente solo está habilitado 343.
order	string	Identificación única del comercio para la orden generada. Máx 100 caracteres
money	string	Código ISO de la moneda de la orden. Máx 3 caracteres, actualmente solo está habilitado "COP"
amount	number	Monto de la orden. Solo acepta números enteros
description	string	Descripción de la orden. Máx 250 caracteres
language	string	Lenguaje del mensaje. Máx 2 caracteres
checksum	string	Cadena de comprobación SHA512 (email+country+order+money+amount+FIXED_HASH)
user_di	string	Número de documento de identificación del pagador. Máx 15 caracteres
user_type_di	string	Tipo documento del comprador. Max 3 caracteres.
user_name	string	Nombre del comprador. Max 25 caracteres.

200 La ejecución retorna un JSON estructurado con los siguientes campos:

{
   "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”
   }
}