Skip to main content

Hosted Fiat Payout Session

Overview​

A Hosted Fiat Payout Session provides an end-to-end checkout flow where customers convert cryptocurrency to fiat through a hosted interface. This solution includes KYC verification, payment method selection, and transaction monitoring through Webhooks.

Use the POST checkout/payout/fiat endpoint to initiate hosted payout sessions.

The session provides a simple and secure, hosted end-to-end flow allowing your customers to offramp to your application. It includes access to the Business Dashboard, providing an overview of all your accounts, transactions, and customers, as well as the ability to download reports and manage integration settings.

Example Scenario​

Consider a remittance company enabling customers to send money home by converting their crypto holdings:

Setup:

  • CustomerID: Sender's profile with KYC verification
  • Input: Customer's cryptocurrency holdings
  • Output: Local fiat currency
  • Destination: Recipient's local bank account

Key Implementation Features:

  • Hosted checkout flow with HostedURL for secure transactions
  • Integrated KYC verification during session
  • Payment method selection through hosted interface
  • Webhook notifications for transaction status updates

Recipe​

Implement a scenario as described above by following the steps below.

Hosted Checkout Step Diagram

1. Initiate a Hosted Checkout Session

Submit a POST request to start a Hosted Checkout session. In your request, include your API Key in the header along with the transaction details and the customer's KYC data. View the POST checkout/payout/fiat endpoint for detailed instructions on initiating a session. The response will provide you with a HostedURL and a CheckoutPaymentID.

2. Handle the API Response

Store the HostedURL and CheckoutPaymentID received. These are essential for validating transaction completion and monitoring your customer's activity.

3. Direct the Customer to Payment

Redirect your customer to the HostedURL to carry out the transaction on Noah's secure checkout page.

4. Transaction Status Updates via Webhooks

Set up to receive notifications through webhooks about the status of the transaction. These will inform you of successful transactions through a Successful Transaction Webhook and of any failures via a Failed Transaction Webhook. For more details, view Transactions Webhooks.

5. Post-Transaction Account Management

Following a successful transaction, adjust your customer’s account balance accordingly, reflecting the items described in the LineItems field exactly. All transaction attempts, successful or otherwise, are recorded in your Noah Business Dashboard for tracking and analysis.