Skip to main content

Quick Start

Overview​

This Quick Start guide is designed to prepare you for submitting your first transaction request, by guiding you to create a Customer in NOAH, using our Business API.

1. Access Your Business Dashboard​

Connect With Our Team​

  • Contact us at business@noah.com or fill out our First Contact Form.
  • A NOAH representative will then reach out to assess your business needs and discuss the best integration model.

Register Your Sandbox Account​

  • Register for a standard NOAH account through our Business App using the business email address responsible for your integration with NOAH.
  • Notify your NOAH Business contact, once registered, they will ask for the email address you registered with.
  • We will upgrade your account to access our Business Dashboard, this will enable your access to the Business Dashboard.

Kick-Off Your Onboarding​

  • Your NOAH Business contact will be in touch to kick-off your Onboarding process.
  • During this stage, we initiate Know Your Business (KYB) checks and Onboarding review based on your institution. You can still begin your integration and test in the sandbox while the Onboarding is in progress.

For more on KYB and Onboarding, see Compliance Models.

2. Generate your API Key​

Once your Business account has been provided:

  • Log into your Business account at business.sandbox.noah.com.
  • Navigate to Configuration → API → API Keys → Create New
  • You can provide a Label to identify a specific API Key.
  • Expiry Dates are optional, if you provide one, your API Key will become invalid as of the date you have set.

Review our Authentication docs for details on using your API key securely.

Public Keys & Request Signing

Request Signing is optional in Sandbox and required in Production - providing a Public Key when generating your API Key, will enable Request Signing. We recommend that you enable Request Signing before migrating to Production.

Read more about Request Signing →

3. Create Your First Customer​

After obtaining your Sandbox API Key, you can call the PUT Customers endpoint to pass our system with the Reliance Model KYC data for a customer.

curl -X PUT "https://sandbox.noah.com/api/v1/customers/cust54321" \
     -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "FullName": {
             "FirstName": "John",
             "LastName": "Doe",
             "MiddleName": "Tester"
           },
           "DateOfBirth": "1992-03-25",
           "Email": "john.doe@example.com", // Required for U.S. residents
           "PhoneNumber": "+34671234567", // Required for U.S. residents
           "Identities": [
             {
               "IssuingCountry": "ES",
               "IDNumber": "123456789",
               "IssuedDate": "2019-06-15",
               "ExpiryDate": "2029-06-15",
               "IDType": "Passport"
             }
           ],
           "PrimaryResidence": {
             "Street": "Calle Mayor 45",
             "Street2": "Piso 2B",
             "City": "Madrid",
             "PostCode": "28013",
             "State": "MD",
             "Country": "ES"
           }
         }'
  • Replace "YOUR_SANDBOX_API_KEY" with your API Key, generated from the Business Dashboard.
  • On success, the returned 200 response confirms that the customer record was updated.
  • Log into your Business Dashboard and navigate to the Customers section to view this customer record.

4. Begin Your Integration​

After successfully creating a customer, it’s time to run some test transactions. Refer to our integration recipes for detailed guidance on your chosen use case:

  • Bank Onramp – Accept bank transfers in fiat and receive near-instant settlement in crypto.
  • Global Payouts – Convert crypto and stablecoins to fiat, and disburse funds using local payment methods.
  • Automated Payouts - Accept deposits in crypto or stablecoins, and automatically payout fiat to local payment methods.
  • Hosted Checkout – Offer a streamlined payment interface to your customers to accept or payout fiat in 120+ currencies.

You can also configure webhooks to receive real-time updates on your transaction statuses. Webhook Subscriptions →

5. Migrate to Production​

Our team are available to support you through the integration and onboarding process to ensure a smooth migration to production. Once your Onboarding and KYB procedures are complete, we will work closely with you to prepare for a migration to production, and perform the required testing.

We’ll guide you through this transition to ensure everything is optimized for a frictionless production launch.

Additional Resources​

• Compliance & Identity – Dive deeper into KYC and AML requirements.
• API Reference – Full endpoint documentation, request/response schemas, and usage notes.
• Global Payouts API – If you need to send funds globally in multiple payout methods.

For questions or additional support, reach out anytime at business@noah.com.