Skip to content

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