Skip to content

Cash Pickup Example

Introduction

This guide is an addition to the Payment example and will cover some details about cash pickup transactions.

Work on this guide is on going, and things might change over time.

Cash transactions can be picked up at multiple banks, that we have partnered with. Final list of which is defined on the stage of transaction funding for each transaciton individually.

Let's assume you have FCMB and UBA cash corridors enabled in our system. And you also have wallet connected to those corridors: single-wallet with 1000 USD.

Creating the transaction

When you are creating transaction in our system, we do not validate if you have enough balance in the wallet. All enabled corridors are available for you at this stage.

Funding the transaction

When you are trying to fund transaction, we will validate if you have enough money in the wallet to fund each corridor individualy, and will exclude corridors which have not enough money in the connected wallet.

Let's take a look at couple examples:

  1. You trying to send 50 USD to John Doe.
    • single-wallet have ehough money to fund this transaciton.
    • We will deduct 100 USD from single-wallet (50 USD for each corridor).
    • Recipient will receive SMS which includes FCMB and UBA as possible pickup locations.
    • If recipient will pickup money at FCMB, we will update our system and return 50 USD back to the single-wallet.
  2. You trying to send 2000 USD to Ronald McDonald.
    • Wallet does not have ehough money to fund this transaction.
    • Transaction will not be funded. You will receive 422 status code in the response.

After transaction has been funded it's not possible to change corridors available for pickup locations.

Waiting for the transaction to complete

After transaction has been succesfully funded, recipient have 15 days to pickup the money.