CashPayment Tutorial

In this example we’ll go through all of the steps and give examples on what you’ll need to do to implement a call to receive cash payment from customers. Once you’ve read through this guide you’ll know everything that is required by us for you to use our cash payment network.

Let's assume you want to top up John Doe's USD wallet in your fintech app. To do so, you must first generate a UPC slip number for John Doe via api doc. The UPC code can be fixed or vary within a specified range depending on your wallet credit configuration. It can also be set for either single-use or multiple-use scenarios.

Once the UPC code is generated, you are required to create a payment slip that includes:

  • A barcode (in TYPE_CODE_128_C format) corresponding to the UPC code
  • Cashier instructions.
  • Customer information

The user can then make payments at any authorized retail outlet.

To view a sample payment slip, please visit; https://whitelabel.markets/demos/apex/cashpayment-barcode-preview/{UPC}

Getting store locations

Below is the URL for accessing our cash payment network, which you can embed in your application.

https://whitelabel.markets/demos/apex/participating-locations/{UPC}

Authentication

All API calls on APEX are authenticated. API requests made without authorization will fail with the status code 401: Unauthorized.

  • Log in to your APEX dashboard
  • Navigate to Settings
  • Select API keys from API & Webhook section to view and copy your keys

Don't take any chances

If you think your keys may have been compromised (for instance, you accidentally committed them to Git), you should immediately generate new ones using the Generate new keys button on the Settings> API & Webhook page on your dashboard. This will invalidate all existing keys and give you a new set, and you can then update your app to use the new ones.

Merchant Responsibilities:

The merchant must provide a pre-authorization URL. All cash payment requests, along with the necessary transaction verification data, will be sent to this URL.

  • If our server receives a 200 status code from the pre-auth URL's POST request, the transaction will be marked as successful.
  • Otherwise, the transaction will be marked as failed

Simulating Cashier Approval

You can effortlessly replicate the cashier transaction process by utilizing this API