Solicitudes de cobro vía API se realizan mediante HTTP request tipo POST y el body de la request debe estar en formato JSON. Para hacer uso de la API el comercio debe contar con su merchant_code y merchant_api_token respectivo.

Formato request:

• Los headers deben contener “merchant_code”, “merchant_api_token”.
  • El body debe poseer el formato:

{
	"contract_date": "DD-MM-AAAA",
	"charges": [
		{
			"id": "{{rut sin puntos ni guión}}",
			"merchant_order_id": "{merchantOrderID}",
			"amount": "{{monto (integer) }}",
			"description": "{{descripción de máximo 30 caracteres}}"
		},
		...
	]
}

Formato response:

{
    "msg": "Success processing charges",
    "valid": {{numero de cobros validos procesados}},
    "invalid": {{numero de cobros invalidos rechazados}},
    "duplicates": {{numero de cobros duplicados rechazados}},
    "rejected": [ //detalle cobros rechazados
        {
            "id": "{{rut usuario}}",
            "amount": "{{monto}}",
						"merchant_order_id": "{{merchant order id}}",
            "desc": "{{descripción}}",
            "code": "{{codigo de rechazo}}"
        }
    ],
    "error": null
}

Restricciones de uso:

• Los nombres de los campos en los headers y body de la request deben ser exactos, o no se procesará la solicitud.
• Las solicitudes de cobro se deben enviar con 2 días hábiles de anticipación a la fecha de expiración de los cobros y antes de las 12:50 horas Chile.

• Existe un limite de seguridad de $100.000.000 CLP por cobro.
• Cobros con fecha de expiración en días feriados o fines de semana serán rechazados automáticamente.
• Cobros con “amount” no entero o texto no serán procesados.
• El peso del payload de la request no debe superar los 5MB, equivalente alrededor de 30.000 cobros por llamado a la API.

Ejemplo solicitud de cobros vía API.

URL: {{API_URL}}/dd/charges/read/api.

Método: POST

Headers:

{
	"Content-Type": "application/json",
	"merchant_code": "cl_sandbox",
	"merchant_api_token": "8KlsTmElN0lKpxrJJnDtyZyxfHyCMmrFh7wjTWu4GJJJt9XZtjaQzDMqAHRNCRfp"	
}