Register

E-Merchant Wallet Creation API

Create customized wallets for e-commerce payment transactions.

How does it work?

The E-Merchant Wallet Creation API allows merchants request the creation of customized wallets to be operated by them on their platforms for management of funds and payments.

  1. The merchant makes a request on behalf of the customer to generate a wallet using the customer's valid registered phone number. If phone number is not registered with the communications authority, request fails.

  2. The merchant gets a PENDING status of while awaiting wallet generation.

  3. Merchant receives a notification of wallet details via a callback URL.

NOTE: This is different from the Wallet Creation API. Here merchants are not required to provide biodata used for the wallet creation process. Biodata is retrieved from the phone number ID authority (in this case, National Identity Management Commission).

Go Live

Step 1 - Generate Merchant Custom Wallet

Request URL

POST - {baseURL}/e-merchant-wallet-create/api/CustomerAccount/GenerateAccountForPatnershipsV2

Try it out !

  1. Merchant initiates request on behalf of customer using the request model below.

  2. Merchant is required to pass a valid x-Api-key value in the header of their request. This value would be provided by the bank.

  3. phoneNumber provided is validated against the ID authority as registered and valid. If "Not Found", request fails.

  4. A successful call to this endpoint would return a PENDING status of wallet generation. The wait time for wallet generation is a maximum of 10 minutes.

  5. Merchant receives a callback once wallet generation process is completed.

The Callback Model

Clients are to build their callback following the specification below. Your callback URL would be profiled to your assigned channelId.