Charge requests via API are made through HTTP request type POST and the body of the request must be in JSON format. To make use of the API the merchant must have its merchant_code and merchant_api_token.

Request format:

• The headers must contain “merchant_code”, “merchant_api_token”.
  • The body must have the format:

{
	"contract_date": "DD-MM-AAAA",
	"charges": [
		{
			"id": "{{RUT without dots or dashes}}",
			"merchant_order_id": "{merchantOrderID}",
			"amount": "{{amount (integer) }}",
			"description": "{{description of maximum 30 characters}}"
		},
		...
	]
}

Response format:

{
    "msg": "Success processing charges",
    "valid": {{number of valid charges processed}},
    "invalid": {{number of invalid charges rejected}},
    "duplicates": {{number of duplicate charges rejected}},
    "rejected": [ //detail of rejected charges
        {
            "id": "{{User RUT}}",
            "amount": "{{amount}}",
						"merchant_order_id": "{{merchant order id}}",
            "desc": "{{description}}",
            "code": "{{refusal code}}"
        }
    ],
    "error": null
}

Usage restrictions:

• Field names in the request headers and body must be accurate, or the request will not be processed.
• Charge requests must be sent 2 business days prior to the expiration date of the charges and before 12:50 Chilean time.

Usage restrictions:

• Field names in the request headers and body must be accurate, or the request will not be processed.
• Charge requests must be sent 2 business days prior to the expiration date of the charges and before 12:50 Chilean time.
• There is a security limit of $100.000.000 CLP per charge.
• Charges with expiration date on holidays or weekends will be automatically rejected.
• Charges with non-integer “amount” or text will not be processed.
• The payload weight of the request must not exceed 5MB, equivalent to about 30,000 charges per API call.

Example of a charge request via API.

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