Use Case

Overview

Noxxo offers JSON REST APIs that support various payout methods, allowing you to build a fully controlled user journey. This guide explains how to implement bank wire payouts with streamlined KYC and fast settlement to end-user accounts.

Estimate Quote

Fetch real-time exchange rates and fees for each transaction. This lets you show users exactly how much stablecoin they need to pay and how much local currency they will receive. No user information is needed at this stage.

Onboard User

Create user required first step before any payouts can be made. Each user must have a unique email address.

Add Bank Account is mandatory step prior to confirming payout request, but may be called at any point, not only while onboarding new user. You can add multiple accounts for each user, even in different countries. The system checks for duplicate bank details using the BIC/SWIFT code and account number. Make sure the bank account holder’s name matches the user’s KYC/KYB information, or the payout may fail.

User Identity Verification

The Customer Identity Verification API is a versatile API that allows you 3 options to streamline KYC.

A. Reusable KYC If you use Sumsub as your KYC provider, this API will allow you to pass a Sumsub token to us, which will mean that customers will be able to skip KYC entirely!

B. Get KYC/KYB Url This API provides a robust, fully automated compliance-as-a-service solution for both individuals and companies. It streamlines the user verification process by generating a unique, secure URL for each verification request. Users can upload required documents through this URL, and the system automatically processes, verifies, and provides real-time feedback on the verification status.

C. Import KYC/KYB info This option is available subject to a compliance reliance review. You can submit KYC documentation that you have already collected from your customers directly to Noxxo. Please note that Noxxo will still verify all submitted information and may request additional documents from the customer if necessary.

Payout via Bank Wire

Create Payout Request by linking the user, selected bank account, and the quote. Each quote is valid for 15 minutes.

Confirm Payout to send request to local payment rail.

Transaction Status Tracking

Once a payout is created, Noxxo screens the transaction status. Speed of transaction updates differs country by country.

Initial status of Payout request is set to "Acknowledged" and we screen for status change in 15 min intervals. Possible transactions statuses:

• "Pending" means the transaction is being processed and final status of transaction is not received

• "Completed" means the payout was successful and accepted by the beneficiary bank

• "Failed" means the payout was rejected by the beneficiary bank

Webhooks for Updates Set up webhooks to receive automated updates on payout requests and transaction status. You will only receive a webhook when there is a status change.