Pre Order
Creating a REDIRECT pre-order is similar to a REDIRECT order, but it doesn’t require providing a payment method upfront, as the customer will select their preferred payment method during the checkout process.
Generate Pre-Order
Creating a PRE-ORDER:
POST /api/v1/pre-order-checkout/form
Host: latamgateway.com
Content-Type: application/json
ACCOUNT_TOKEN: "<token>"
{
"order": {
"code": "123",
"notification_url": "https://yoursystem.com/postback/",
"redirect_url": "https://yoursystem.com/finish_checkout?auto_redirect=true",
"value": 50.00,
"additional_info": "A description of your order, as a string"
}
}
Params descriptions
Field | Description | Value Type | Requirement |
---|---|---|---|
order.code |
Order reference in your system | String | Required |
order.notification_url |
URL to notify when status changes | String | Required |
order.redirect_url |
URL for automatic redirection after checkout ends | String | Optional |
order.value |
Total order value | Number (Decimal) | Required |
order.additional_info |
Additional description of the order | String | Required |
On a successful request HTTP 200 status code, the response will include the following parameters:
{
"form_id": "dbcedec8-f587-4203-8aa4-a74da83fb32a",
"url": "https://latamgateway.com/pre_order_checkout/payment/dbcedec8-f587-4203-8aa4-a74da83fb32a"
}
Business errors due to incorrect or missing parameters are returned with an HTTP 400 status code. The response will indicate which parameter is invalid or missing.
{
"message": "Payment method not supported"
}