PaaS API Docs
  • Getting Started
  • Authentication
  • Use cases
    • Remittance
      • Bonus/Discount on Remittance
    • Business Payments
    • Individual Wallet
    • Business Wallet
    • Payout
  • API References
    • Data Population
      • Spec Sheet
      • Country
      • States
      • Settlement Rates
    • User
      • User Object
        • User Verification
        • Identification Documents
        • User Verification Status
        • CIP Information Status
      • Receive User Object
      • Register a User
      • Update User
      • Business Representatives
        • Business Representatives Object
        • Add Business Representatives
        • Update Business Representatives
        • Get Business Representatives
      • Declaration
        • Declaration Object
        • Declaration
      • Initiate Verification
      • Get User by ID
      • Get Verification Status
      • Add a Receive User
      • Update a Receive User
      • Get Receive User List
    • Funds
      • User Funding Account Object
      • Funding Account Widget
        • OAuth Integration
        • Bank Verification Status
      • Wallet Object
      • Create a Wallet
      • Get Wallet Details
      • Get User Funding Account
      • Delete User Funding Account
      • Add a Receive Account
      • Update a Receive Account
      • Get Receive Accounts
    • Payout
      • Get Banks
      • Get Payers
    • Transaction (External)
      • Transaction Object
      • Create Transaction
      • Get Transaction by ID
      • Cancel Transaction
      • Transaction Delivery
      • Get Transaction Limits
    • Transaction (Wallet)
      • Wallet Transfer Object
      • Create Transfers
        • Load Wallet
        • Unload Wallet
        • Wallet to Wallet Transfer
      • Get Wallet Transfer Details
      • Get Limits
    • Transaction (Payout)
      • Payout Transaction Object
      • Create Payout Transaction
    • Webhooks
      • Subscribe
      • Integration
      • Events
    • Error Codes
  • Sandbox
    • User: Test Values
    • Funds: Test Values
    • Transaction: Test Values
  • Changelog
    • 2023
      • February 14, 2023
      • January 06, 2023
    • 2022
      • December 28, 2022
      • December 26, 2022
      • December 23, 2022
      • December 2, 2022
      • November 21, 2022
      • November 11, 2022
      • October 31, 2022
      • October 17, 2022
      • August 31, 2022
      • August 1, 2022
      • July 25, 2022
      • May 23, 2022
      • April 7, 2022
      • March 30, 2022
      • March 23, 2022
      • Feb 21, 2022
      • Feb 15, 2022
      • Jan 24, 2022
      • Jan 19, 2022
      • March 10, 2022
Powered by GitBook
On this page
  • Integration Recommendations
  • 1. User Registration
  • 2. User KYC Verification
  • 3. User Tier Verification
  • 4. Create a Wallet
  • 5. Create Wallet Transfers and Transactions

Was this helpful?

  1. Use cases

Individual Wallet

Read for API integration recommendations for individual wallet use case

PreviousBusiness PaymentsNextBusiness Wallet

Last updated 2 years ago

Was this helpful?

Wallets allow you to hold funds of your users and the users are able to send those funds to other wallet holders within the system or externally to a receiver.

Integration Recommendations

This section will guide you through the API endpoints for the individual wallet use case which includes creating wallets, loading wallets, unloading wallets and creating transfers and transactions using wallets. Please note that these are recommendations for standard flow and can be customized as per your needs.

1. User Registration

The first step in creating the user flow is to in our system. Individual users need to be registered with the business field as false. Users can only be registered from the country which has been enabled for you as per your agreement with Machnet. Fields outlined as mandatory in the user object are required during registration.

2. User KYC Verification

You will have to provide user information so that necessary KYC checks can be conducted on the sender. In order to run KYC on the sender, you will have to:

  1. Know what

  2. Collect and.

User's KYC verification is conducted using the following information:

  • Name

  • Date of birth

  • Gender

  • Address

  • Email

  • Phone number

3. User Tier Verification

Users may be placed in different tiers based on the user information (CIP tags) they provide. The tiers dictate the following limits for each user:

  • Load limit: Annual, monthly and daily limit for transfers from linked bank/card to wallet

  • Unload limit: Annual, monthly and daily limit for transfers from wallet to linked bank/card

  • Transfer limit: Annual, monthly and daily limit for wallet to wallet transfers

  • External transaction limit: Annual, monthly and daily limit for external transactions

  • Hold limit: Amount of funds that can be held in a wallet at a certain time

The tiers, their corresponding information requirements and eligibility limits are outlined in your spec sheet. Our APIs also provide the following:

4. Create a Wallet

5. Create Wallet Transfers and Transactions

Users can create transfers from and to wallets and also use wallets as funding sources for external transactions.

  1. Load: Adding funds to the wallet from a linked bank account or card.

  2. Unload: Withdrawing funds from the wallet to a linked bank account or card.

  3. Transfer: Send funds to another VERIFIED user's wallet.

Once you have submitted the information, . Each information required for KYC verification is referred to as a CIP tag and each CIP tag has their own verification status. Only when all CIP tags required for KYC verification (listed above) are verified will the KYC status of the user be verified.

You can submit the additional information of the user and update existing information collected from the user using the . Each time new information is submitted, make sure to on the user to ensure verification of all submitted information.

You can for a VERIFIED user to hold funds. You can view the wallet details and balances using Once the wallet status is VERIFIED, users can perform wallet related transfers and transactions.

The following are the different types of .

Along with this, users can . These are international remittance and business payments transactions. The user flow is the same as that outlined in the and Business Payments use case section but in this particular case, the funding source will be the created wallet instead of a bank account or card.

you check what KYC information has been provided by a user and its verification status
Current KYC status of the user
Current tier of the user
Remaining transaction limits of the user in the current tier
Submitted CIP information and verification status of the user
Transaction limits per tier and corresponding CIP information for all users of the Client
create a designated wallet
this API.
wallet transfers that users can create
create external transactions using wallet as a funding source
Remittance
KYC information is required for the sender
initiate KYC
register the user
Initiate KYC process for the user
send the required information to Machnet
Update KYC information API