Introduction

Allow your customers to deposit funds using their local currency and payment options, including bank transfer or mobile money, and have the funds automatically credited to your USD/USDT/USDC settlement wallet.

User Flow

Build out a simple UI in your app to allow your customers to seamlessly deposit using local fiat and payment options.

Collection steps & API overview

A guide of the user journey steps for making collections/deposits.

To get started, open the recipe below:

UI Tutorial

This is a guide to showcase a proposed UI/UX framework that can be followed to best build out the required flows.

1. Initiates deposit

To begin, a customer will initiate a deposit.

2. Country selector

For cross border collections or depositing from another person's account or mobile wallet, a country selector will be necessary for a customer to select between all supported countries where the recipient is based. If a customer can only deposit to their own saved account, then the country saved can be passed through to the api only.

3. Select Payment Method/ Channel

The supported and enabled payment channel of the chosen country will be shown to the customer for them to select their preferred method of payment.

4. Enter deposit amount

Once the preferred payment channel has been selected, the customer can now enter the amount they would like to deposit. The USD amount will be entered and the api will provide the rate conversion to the local fiat of the country selected. To show the local currency conversion on the same screen will require the calculations to be handled by partner. The same will go whether you would like to allow customers to enter the fiat amount opposed to the $ amount.

The api will also provide the any relevant min and max transaction limits relevant for the transaction which can also be displayed to alert customers upfront.

5. Enter Recipient Details (Mobile Money deposit only)

It's now time to add the relevant recipients details to which the customer wants to make the deposit via mobile money.

• First name - A text field for the customer to enter the first name of the recipient

• Last name - A text field for the customer to enter the last name of the recipient.

• Mobile number - A text field that contains the dialling code and number of the recipient.

• Select provider - A drop down field that will show all the supported networks passed through by the api.

• Reason for Sending - A dropdown that will contain the relevant pre-defined reasons here. This is necessary if you are allowing customers across borders to deposit money on other beneficiary wallets on your platform.

6. Review deposit request

This screen will show the customer all of the transactional details for their deposit request for them to review and confirm that it is correct. The details that you will get from the SubmitPaymentRequest endpoint will include:

6.1 P2P or Manual Bank Transfer

• Payment channel - payment method

• Payment Network - selected bank name

• Total Amount in USD

• USD/Fiat Rate

• Total Amount in Fiat

• Fee - this will need to be built in by partner if fee's or any other costs are passed on to customers for transactions.

• Total Amount Received - this calculation will need to be built in on the partner's side.

  6.2 Mobile Money

• Payment channel - payment method

• Payment Network - selected mobile network/ provider

• Mobile number - mobile number to be in format of country code and number.

• Total Amount in USD

• USD/Fiat Rate

• Total Amount in Fiat

• Fee - this will need to be built in by partner if fee's or any other costs are passed on to customers for transactions.

• Total Amount Received - this calculation will need to be built in on the partner's side.

7. Deposit Banking Details (Bank Transfer only)

If your customer has selected bank transfer as their payment method, then they will be shown the relevant bank account details that they are required to make the deposit into. This screen is shown once they have accepted the collection request. (transactional quote)

🚧

Remember!

Your customer will be required to make the deposit to the relevant bank account using the correct reference provided. Once they have made the payment and the funds reflect in the account, then only will the deposit be approved.

8. Deposit approved/ submitted

8.1 Manual Bank Transfer

When deposit funds are reflecting in the correct bank account, the deposit will be approved by the YC team. At this time, an api request will be sent to top up your customers wallet on your platform.

8.2 Mobile Money

Once your customer has accepted the deposit request, they will be notified to check their mobile money phone number to approve the request from their mobile money network provider. Once they have approved the request, an api request will be sent to top up your customers wallet on your platform.