Payzone Cash

​

How a Payzone Cash payment works

1. The customer selects Payzone Cash at checkout.
2. Payrails creates a cash reservation with Payzone and returns a redirect URL to a Payrails page that shows the payment code.
3. The customer presents the code at a payment point in the Payzone network and pays in cash.
4. Payzone notifies Payrails of the payment, and Payrails updates the payment.

​

Supported currencies and countries

​

Supported workflows

​

Before you begin

1. Set up a Payzone integration in your workspace. Contact your Payrails account team if Payzone isn’t listed in your Payrails Portal yet.
2. Ask Payzone for your Payzone Cash account details: the merchant ID, the POS ID, the provider ID, and the four MAC keys.
3. In the Payrails Portal, go to Settings → Integrations, open your Payzone integration, and fill in the fields marked Required for Payzone Cash.
4. Select Payzone Cash under Payment methods, and save.
5. Add Payzone Cash as a payment option in a workflow that uses instant capture.

​

Request fields for Payzone

​

Authorize a Payzone Cash payment

{
  "amount": {
    "value": "150.00",
    "currency": "MAD"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "payzoneCash",
      "amount": {
        "value": "150.00",
        "currency": "MAD"
      }
    }
  ],
  "meta": {
    "customer": {
      "reference": "customer-1234",
      "name": "Youssef",
      "lastName": "Benali",
      "language": "fr"
    },
    "order": {
      "billingAddress": {
        "city": "Casablanca",
        "country": {
          "code": "MA"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Payzone handles Payzone Cash

• Payzone sends a callback when the customer pays, and Payrails moves the payment from pending to captured. Payrails can’t query the payment status with Payzone, so the callback is the only source of the result.
• To stop a payment the customer hasn’t paid yet, cancel the payment. Payrails cancels the cash reservation with Payzone, and Payzone confirms a reversal through a callback.
• Payzone can decline amounts below its minimum.