**Last updated**: 17 November 2025 | [**Change log**](/products/apms/changelog/)

# OXXO

OXXO is a popular cash payment method in Mexico, allowing customers to pay for online purchases at any of the 20,000+ OXXO convenience stores nationwide.

Note
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

details
summary
Product overview
### Why use Oxxo

This payment option is ideal for customers without bank accounts or credit cards. Your customers are presented with an OXXO voucher with a unique barcode on your checkout page. They can use this voucher at any of the OXXO stores to pay in cash. Once the payment is processed, you are notified, and the order is confirmed.
OXXO is widely used for e-commerce, bill payments, and digital services, making it a trusted and efficient solution for cash-based transactions.

### Feature summary

| Payment type | Country | Currencies | Recurring | Reversals | Partial reversals | Disputes |
|  --- | --- | --- | --- | --- | --- | --- |
| Post-pay voucher | Mexican | MXN | ❌ | ❌ | ❌ | ❌ |


- Minimum Transaction Value: 10,00 MXN
- Maximum Transaction Value: 10.000,00 MXN
- Voucher validity: min. 1 day, maximum 30 days


## Get started

Get started using our [API reference](/products/apms/openapi) and set your headers.

## Request

`POST` `https://try.access.worldpay-bsh.securedataplatform.com/apmPayments`

### Example request

### Parameters

## Response

### Successful request response

* an HTTP code `201`
* a `paymentId` which is unique to the payment - we recommend storing the "id", as you can use it to manage the payment later
* a `redirect` to redirect your customer to the APM provider to complete the payment
* an link to query the payment status
* an object which will give flow information such as `method` (e.g. `oxxo`) and type (`direct`)
* a `commandId` generated by us identifying a single merchant interaction (e.g. `cmdYNdIHBPJwbkjLiykzTx0`)


### Example response

Successful
{
  "paymentInstrument": {
    "method": "oxxo",
    "type": "direct"
  },
  "paymentId": "uK9Oh5zz4yKhGuFofhhnC1loxh8YRI6ChuSe7sEy6rPwh_KRcHUrrs1qJtQso9gjbUhveud3wEUka96FeYiU0Tp38_5OaydAORxUcSiX2IyXwK6gT8PDO-IvQ-BUMt_iUsGZa3xbZdUeTuq6p3rC1PTBiR7CzE6-theYuKncW_KImK-l23r7xoTI7CEzKmR8",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/uK9Oh5zz4yKhGuFofhhnC1loxh8YRI6ChuSe7sEy6rPwh_KRcHUrrs1qJtQso9gjbUhveud3wEUka96FeYiU0Tp38_5OaydAORxUcSiX2IyXwK6gT8PDO-IvQ-BUMt_iUsGZa3xbZdUeTuq6p3rC1PTBiR7CzE6-theYuKncW_KImK-l23r7xoTI7CEzKmR8"
    }
  },
  "_actions": {},
  "redirect": "http://secure-test.worldpay-bsh.securedataplatform.com/redirect?tokenId=6a4270bc-7ab4-4ffc-a511-bb04f59609a1",
  "commandId": "cmdEy5vwB0krLe9eMwAcE66c0"
}
Error response
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
#### Errors

Check out our API reference for the full [error code schema](/products/apms/openapi/other/payment#other/payment/response&c=400).

**Next steps**

[Manage your OXXO payment](/products/apms/manage/)