PayCash

Accept cash payments from Mexican customers using PayCash. Customers receive a payment voucher and complete the transaction by paying in cash at a participating store (e.g. OXXO, 7-Eleven).

This payment method only supports one-time (non-recurring) payments. It is available for MXN transactions to customers in Mexico.

The legacy PWC payment option value is still accepted as an alias for PAYCASH and routes to the same flow.

Payment flow

Several steps occur between creating the order and completing the PayCash charge.

Create an order with the customer’s information.
Encrypt and send the pay order request.
Redirect the customer to get their cash voucher.
Confirm the payment and inform the customer of its outcome.

Creating the Order

Follow the standard create order flow, setting customer.mobile to the customer’s Mexican phone number and customer.country to MX.

{
   "customer":{
      "firstname":"Ana",
      "lastname":"García",
      "mobile":"+521234567890",
      "country":"MX",
      "email":"ana@example.com"
   },
   "order":{
      "amount":250,
      "reference":"40cac2b6-6793-489a-8c96-c97a18b3c58a",
      "description":"Deposit via PayCash",
      "currency":"MXN"
   }
}

Initiating the Payment

Encrypt the order reference and paymentoption before sending it to the pay order endpoint.

{
    "reference": "40cac2b6-6793-489a-8c96-c97a18b3c58a",
    "paymentoption": "PAYCASH"
}

{
  "data": "B9pQJ1HoxybgfjNnEro+26w7lQZ6jriF3AFiUeGH2Ggacn6cF0srUlqiHEXeEncJcMw6ThDobjuS+AsmvhNfvGPGMddjbt5rcK2JrUnUI4cHk0XebJKoNnjEqivcyq0UKEMdYOLd6mYZtvKu5FMlpz0Lo0aMY49pnYvUGLSsCf/wOhlPx9PHgQDXptT+WBJcO3lzeD8O0S4IVSWPCWPLi7GhGlqhZpheEi1FHq39TCHk12hL3sqkkIktZIkkQVAe8AkwZGhy/CMJZrTzU6IXZr2ulT7mJenZljSk66m0pARcUqwMw/+5PEPECDo8SX3IkX2hmym02pGuWZeHE9ONWcaW7h8UIroQ/+kThz/RtP/UMiK3596cij66JcW+RcXKPiqNKysskcnaOlQFIFuhEiAczimLgd320RrQzehaw1C33UGsCzAG1p2EnDthjTF63BZtEhVlu9kN7qtFCz9AvojZeaZFKOxpJJ0usfwl9Hq5oAa56AFt/3IIsvqrAktTOyMgQ/jGQ6uhRYpA6UAH0CcYyv7L99hgVtRTXAxA/rpCtY7aTR9Pjxb5Lt1IV0Q1V8fWxAv0yY+ss07qeiSIsccsdJiN4LaMx3RvmDlu54XF68w51L34hOCDj/NBoPVUZrSaCJK2GPJ6CjOHI8q2/U2TkU+y+a80XCAC/rgqGhw="
}

Upon receiving your request, we will return a successful response with a redirect URL for our hosted PayCash payment page.

200 OK

{
    "data": {
        "paymentDetail": {
            "redirectUrl": "https://checkout-widget.epayclub.com/apm/PGW-PAYREF-CFE5A0D0D31B4E54AABAAD89F123F422",
            "recipientAccount": null,
            "paymentReference": "CP1B3F264C-8DB1-47C1-A50E-6494FB927D51"
        },
        "bankTransferDetails": null,
        "orderPayment": {
            "orderId": 628,
            "orderPaymentReference": "PGW-PAYREF-CFE5A0D0D31B4E54AABAAD89F123F422",
            "currency": "MXN",
            "statusId": 2,
            "orderPaymentResponseCode": "02",
            "orderPaymentResponseMessage": "pending-authentication",
            "orderPaymentInstrument": null,
            "remarks": "Order payment initiated",
            "totalAmount": 250.00,
            "fee": 0.00
        }
    },
    "status": "success",
    "statusCode": "02",
    "message": "pending-authentication"
}

Completing the Payment

Redirect the customer to paymentDetail.redirectUrl. This takes them to our hosted PayCash payment page, where we present the voucher code (and a link to view/print it) that the customer takes to a participating store to pay in cash. This is an offline, asynchronous payment method — it can take up to the voucher’s expiry window to be confirmed, and we’ll notify you once it is.

Verifying the Payment

Read the transaction verification section to learn how to verify your PayCash transactions.

Testing your integration

Kindly contact the support team to enable PayCash testing on your account.

Follow these guidelines to successfully test your PayCash integration:

Use a MXN order currency — PayCash is only available for MXN transactions.
Set customer.country to MX when creating the order.
Expect the transaction to remain in a pending state until the simulated/test cash payment is confirmed.

Get Started

API Basics

Orders

Payments

Payment flow

Creating the Order

Initiating the Payment

Completing the Payment

Verifying the Payment

Testing your integration

​Payment flow

​Creating the Order

​Initiating the Payment

​Completing the Payment

​Verifying the Payment

​Testing your integration

Payment flow

Creating the Order

Initiating the Payment

Completing the Payment

Verifying the Payment

Testing your integration