# Nodu Docs > Nodu moves money for your customers between bank accounts and crypto wallets, and converts it between currencies on the way. The guides and the API reference of https://docs.nodu.fi, as Markdown. API servers: https://api.nodu.fi (Production) and https://api.sandbox.nodu.fi (Sandbox). The whole OpenAPI document: [/default.json](/default.json). ## Guides: Get started - [How Nodu works](/guides/index.md): An overview of a Nodu integration: the parties, the objects of the API and how they connect, and the two choices that every integration makes. - [Quickstart: your first sandbox transfer](/guides/get-started/quickstart/index.md): Go from a sandbox API key to a completed test transfer: create and verify a customer, create a quote and a transfer, simulate the funding and the proof of ownership, and read the result. - [Environments and API keys](/guides/get-started/environments-and-api-keys/index.md): The base URLs of the Nodu sandbox and of production, what differs between the two environments, and how you get and keep API keys. - [Go live](/guides/get-started/go-live/index.md): How to build and test a Nodu integration in the sandbox, recommended integration practices, and how you then get access to production. ## Guides: API basics - [Authentication](/guides/api-basics/authentication/index.md): How to send your Nodu API key with a request, what a 401 or 403 response means, and how to keep API keys safe. - [Idempotency](/guides/api-basics/idempotency/index.md): Use Idempotency-Key to recover stored POST responses and reconcile uncertain outcomes; clientReferenceId helps match API objects to your records. - [Errors and rule codes](/guides/api-basics/errors-and-rule-codes/index.md): Use HTTP statuses, error codes and rule identifiers to handle Nodu API errors. - [Pagination](/guides/api-basics/pagination/index.md): How to read list results from the Nodu API page by page with limit, cursor and nextCursor. - [Receive and verify webhooks](/guides/api-basics/webhooks/index.md): Set up an endpoint for Nodu webhooks, verify signatures, handle retries and repeated deliveries, and look up the event types. ## Guides: Customers - [How onboarding works, and customer statuses](/guides/customers/how-onboarding-works/index.md): What a Nodu customer is, the two steps of onboarding, and what each customer, verification and application status means. - [Onboarding models](/guides/customers/onboarding-models/index.md): Compare the ways in which Nodu receives a customer's information: from the customer on Nodu's pages, from you through the API, or copied from your Sumsub account. - [Hosted onboarding](/guides/customers/hosted-onboarding/index.md): Onboard a customer on Nodu's pages: create the customer, redirect to the terms page and the verification page, and follow the outcome. - API onboarding - [Onboard a customer through the API](/guides/customers/api-onboarding/create-a-customer-with-a-full-application/index.md): Onboard a customer through the API: create the customer with an application, upload documents, submit it for review, and follow the outcome. - [Reuse verification with Sumsub sharing](/guides/customers/api-onboarding/sumsub-sharing/index.md): Create a Nodu customer from an applicant that you have already verified in your own Sumsub account, using a share token. - [Upload and replace documents](/guides/customers/api-onboarding/adding-documents/index.md): How to upload, check and replace the documents of an application, and which document kinds the API accepts for individuals and for businesses. - [Associates of a business](/guides/customers/api-onboarding/associates-of-a-business/index.md): How Nodu receives the information about the directors, representatives, beneficial owners and shareholders of a business customer in API onboarding. - [Resubmission and rejection](/guides/customers/resubmission-and-rejection/index.md): What to do when Nodu requests more information, issues a final rejection, or suspends or blocks a customer. - Reference - [Industry codes](/guides/customers/reference/industry-codes/index.md): Every value that the industry field of an application questionnaire accepts, with its label and its sector. ## Guides: Transfers - [How transfers work](/guides/transfers/how-transfers-work/index.md): Learn how transfer sources, destinations, deposit instructions and states fit together, with a full Create a transfer request. - [Payment channels](/guides/transfers/payment-channels/index.md): Learn how to list and activate a customer's payment channels and respond to channel statuses. - External accounts and counterparties - [External accounts and counterparties](/guides/transfers/external-accounts/first-party-and-third-party-accounts/index.md): Learn how external accounts relate to counterparties, how accounts take part in transfers, and what you can add or amend after registration. - [Find destinations and requirements](/guides/transfers/external-accounts/destinations-and-requirements/index.md): Find the countries and rails where a customer can be paid out, get the fields that an external account needs, and build your form from them. - [Declare who sends incoming crypto](/guides/transfers/external-accounts/declare-the-originator-of-a-crypto-funding/index.md): Learn when to declare who sends the crypto that funds a transfer, and how to register the originator's crypto wallet: the customer's own wallet at an exchange or custodian, or someone else's crypto wallet. - [Quotes and exchange rates](/guides/transfers/quotes-and-exchange-rates/index.md): Learn how indicative exchange rates differ from quotes, how to use a quote's amounts, fees and expiry time, and how long a transfer keeps the quoted rate. - [Fees and how amounts are calculated](/guides/transfers/fees-and-amounts/index.md): Learn the three transfer fees (service fee, developer fee and network fee), who sets each, and how Nodu calculates the amount that the recipient receives. - Crypto sender and recipient information - [Travel Rule: what Nodu needs to know, and why](/guides/transfers/travel-rule/what-nodu-needs-to-know/index.md): Understand why Nodu needs to know who sends and receives crypto, how wallet ownership differs from custody, and which guide applies to your transfer. - [Self-custody wallets (unhosted)](/guides/transfers/travel-rule/self-custody-wallets/index.md): Learn when Nodu asks a customer to prove that they control their own self-custody wallet, how you handle the transfer state info_required, and what Nodu remembers. - [Wallets at an exchange or custodian (hosted)](/guides/transfers/travel-rule/wallets-at-an-exchange-or-custodian/index.md): Understand why you declare a hosted crypto wallet before creating a transfer, what can happen without a declaration, and how Nodu checks it. - [Handle a transfer that needs action](/guides/transfers/handle-a-transfer-that-needs-action/index.md): Read pending transfer requirements, show each action to the customer, and follow the transfer as it resumes. - [Track and cancel a transfer](/guides/transfers/track-a-transfer/index.md): Learn what each transfer state means, what to show the customer, and how to handle cancellation, failed payouts, refunds, errors and reconciliation. - Reference - [External account requirements by rail](/guides/transfers/reference/external-account-requirements/index.md): Look up the account fields and the counterparty fields that an external account needs on SEPA, SWIFT, Faster Payments, ACH and blockchain networks. ## Guides: Nodu wallets - [Nodu wallets: balances and wallet scopes](/guides/nodu-wallets/balances-and-wallet-scopes/index.md): Learn what a Nodu wallet is, how to create one, what its scope allows, and how to read its balances. - [Fund and pay out from a Nodu wallet](/guides/nodu-wallets/transfers-funded-from-a-wallet/index.md): Learn how to move funds into a Nodu wallet with a transfer, how to pay out from a Nodu wallet, and what happens when its balance is too low. ## Guides: Relays - [Relays: deposit instructions you can reuse](/guides/relays/index.md): Learn when to use a relay, how to create one, how to publish its deposit instructions, and what happens when funds arrive. ## Guides: Sandbox - [Test onboarding in the sandbox](/guides/sandbox/test-onboarding/index.md): Produce each verification outcome in the Nodu sandbox with an address marker or with test documents: approval, a request for more information, and a final rejection. - [Simulate funding in the sandbox](/guides/sandbox/simulate-funding/index.md): Simulate the incoming payment for a transfer or a relay in the Nodu sandbox, follow what happens next, and learn how the simulation behaves. - [Simulate crypto wallet verification in the sandbox](/guides/sandbox/simulate-wallet-verification/index.md): Produce the transfer state info_required in the Nodu sandbox, and resolve it with a simulated or a real proof of ownership of a crypto wallet. ## API reference - [Overview](/api/index.md): The introduction, the servers, the OpenAPI document and every resource. ## API reference: Customers - [Customers](/api/tag/customers.md): Create and retrieve customers, manage applications, and activate payment channels. - [Create a customer](/api/tag/customers/post-v1-customers.md): POST /v1/customers (createCustomer) - [List customers](/api/tag/customers/get-v1-customers.md): GET /v1/customers (listCustomers) - [Retrieve a customer](/api/tag/customers/get-v1-customers-customerid.md): GET /v1/customers/{customerId} (retrieveCustomer) - [Retrieve a link to ToS acceptance page for a customer](/api/tag/customers/get-v1-customers-customerid-tos-acceptance-link.md): GET /v1/customers/{customerId}/tos-acceptance-link (retrieveTosAcceptanceLink) - [Retrieve a link to verification page for a customer](/api/tag/customers/get-v1-customers-customerid-verification-link.md): GET /v1/customers/{customerId}/verification-link (retrieveVerificationLink) - [Retrieve an application](/api/tag/customers/get-v1-customers-customerid-applications-applicationid.md): GET /v1/customers/{customerId}/applications/{applicationId} (retrieveApplication) - [Update application data](/api/tag/customers/patch-v1-customers-customerid-applications-applicationid.md): PATCH /v1/customers/{customerId}/applications/{applicationId} (updateApplication) - [Upload an application document](/api/tag/customers/post-v1-customers-customerid-applications-applicationid-documents.md): POST /v1/customers/{customerId}/applications/{applicationId}/documents (uploadApplicationDocument) - [Submit an application for evaluation](/api/tag/customers/post-v1-customers-customerid-applications-applicationid-submit.md): POST /v1/customers/{customerId}/applications/{applicationId}/submit (submitApplication) - [List payment channels](/api/tag/customers/get-v1-customers-customerid-payment-channels.md): GET /v1/customers/{customerId}/payment-channels (listPaymentChannels) - [Activate a payment channel](/api/tag/customers/post-v1-customers-customerid-payment-channels-channelid-activate.md): POST /v1/customers/{customerId}/payment-channels/{channelId}/activate (activatePaymentChannel) ## API reference: Transfers - [Transfers](/api/tag/transfers.md): Create, retrieve, update and cancel transfers. - [Create a transfer](/api/tag/transfers/post-v1-transfers.md): POST /v1/transfers (createTransfer) - [List all transfers](/api/tag/transfers/get-v1-transfers.md): GET /v1/transfers (listTransfers) - [Retrieve a transfer](/api/tag/transfers/get-v1-transfers-transferid.md): GET /v1/transfers/{transferId} (retrieveTransfer) - [Update a transfer](/api/tag/transfers/put-v1-transfers-transferid.md): PUT /v1/transfers/{transferId} (updateTransfer) - [Cancel a transfer](/api/tag/transfers/delete-v1-transfers-transferid.md): DELETE /v1/transfers/{transferId} (cancelTransfer) - [Simulate funding for a transfer](/api/tag/transfers/post-v1-transfers-transferid-simulate-funding.md): POST /v1/transfers/{transferId}/simulate-funding (simulateTransferFunding) - [Simulate a wallet verification](/api/tag/transfers/post-v1-transfers-transferid-simulate-wallet-verification.md): POST /v1/transfers/{transferId}/simulate-wallet-verification (simulateWalletVerification) ## API reference: Exchange Rates - [Exchange Rates](/api/tag/exchange-rates.md): Retrieve indicative exchange rates. - [List exchange rates](/api/tag/exchange-rates/get-v1-exchange-rates.md): GET /v1/exchange-rates (listExchangeRates) ## API reference: Quotes - [Quotes](/api/tag/quotes.md): Create, retrieve and update a quote containing transfer amounts, fees and an expiry time. - [Create a quote](/api/tag/quotes/post-v1-quotes.md): POST /v1/quotes (createQuote) - [Retrieve a quote](/api/tag/quotes/get-v1-quotes-quoteid.md): GET /v1/quotes/{quoteId} (retrieveQuote) - [Update a quote](/api/tag/quotes/patch-v1-quotes-quoteid.md): PATCH /v1/quotes/{quoteId} (updateQuote) ## API reference: Wallets - [Wallets](/api/tag/wallets.md): Create and retrieve Nodu wallets and their balances. - [Create a wallet](/api/tag/wallets/post-v1-wallets.md): POST /v1/wallets (createWallet) - [Retrieve a wallet](/api/tag/wallets/get-v1-wallets-walletid.md): GET /v1/wallets/{walletId} (retrieveWallet) - [List all wallets](/api/tag/wallets/get-v1-wallets.md): GET /v1/wallets (listWallets) ## API reference: Relays - [Relays](/api/tag/relays.md): Create and retrieve relays, which provide reusable deposit instructions for a customer. - [Create a relay](/api/tag/relays/post-v1-relays.md): POST /v1/relays (createRelay) - [List relays](/api/tag/relays/get-v1-relays.md): GET /v1/relays (listRelays) - [Retrieve a relay](/api/tag/relays/get-v1-relays-relayid.md): GET /v1/relays/{relayId} (retrieveRelay) - [Simulate funding for a relay](/api/tag/relays/post-v1-relays-relayid-simulate-funding.md): POST /v1/relays/{relayId}/simulate-funding (simulateRelayFunding) ## API reference: External Accounts - [External Accounts](/api/tag/external-accounts.md): Register and maintain external accounts and counterparties. - [List external account destinations](/api/tag/external-accounts/get-v1-external-accounts-destinations.md): GET /v1/external-accounts/destinations (listExternalAccountDestinations) - [Get external account requirements](/api/tag/external-accounts/get-v1-external-accounts-requirements.md): GET /v1/external-accounts/requirements (getExternalAccountRequirements) - [Create an external account](/api/tag/external-accounts/post-v1-external-accounts.md): POST /v1/external-accounts (createExternalAccount) - [List external accounts](/api/tag/external-accounts/get-v1-external-accounts.md): GET /v1/external-accounts (listExternalAccounts) - [Retrieve an external account](/api/tag/external-accounts/get-v1-external-accounts-externalaccountid.md): GET /v1/external-accounts/{externalAccountId} (retrieveExternalAccount) - [Update an external account](/api/tag/external-accounts/patch-v1-external-accounts-externalaccountid.md): PATCH /v1/external-accounts/{externalAccountId} (updateExternalAccount) - [Validate an external account for a transfer side](/api/tag/external-accounts/get-v1-external-accounts-externalaccountid-validation.md): GET /v1/external-accounts/{externalAccountId}/validation (validateExternalAccount) - [Archive an external account](/api/tag/external-accounts/delete-v1-external-accounts-externalaccountid.md): DELETE /v1/external-accounts/{externalAccountId} (archiveExternalAccount) - [Create a counterparty](/api/tag/external-accounts/post-v1-counterparties.md): POST /v1/counterparties (createCounterparty) - [List counterparties](/api/tag/external-accounts/get-v1-counterparties.md): GET /v1/counterparties (listCounterparties) - [Retrieve a counterparty](/api/tag/external-accounts/get-v1-counterparties-counterpartyid.md): GET /v1/counterparties/{counterpartyId} (retrieveCounterparty) - [Update a counterparty](/api/tag/external-accounts/patch-v1-counterparties-counterpartyid.md): PATCH /v1/counterparties/{counterpartyId} (updateCounterparty) - [Archive a counterparty](/api/tag/external-accounts/delete-v1-counterparties-counterpartyid.md): DELETE /v1/counterparties/{counterpartyId} (archiveCounterparty) ## API reference: VASPs - [VASPs](/api/tag/vasps.md): Look up exchanges and custodians that can hold hosted crypto wallets. - [List VASPs](/api/tag/vasps/get-v1-vasps.md): GET /v1/vasps (listVasps) ## API reference: Beneficiaries (Deprecated) - [Beneficiaries (Deprecated)](/api/tag/beneficiaries-deprecated.md): Deprecated beneficiary operations. - [List beneficiary destinations](/api/tag/beneficiaries-deprecated/get-v1-beneficiaries-destinations.md): GET /v1/beneficiaries/destinations (listBeneficiaryDestinations, deprecated) - [Get beneficiary requirements](/api/tag/beneficiaries-deprecated/get-v1-beneficiaries-requirements.md): GET /v1/beneficiaries/requirements (getBeneficiaryRequirements, deprecated) - [Create a beneficiary](/api/tag/beneficiaries-deprecated/post-v1-beneficiaries.md): POST /v1/beneficiaries (createBeneficiary, deprecated) - [List all beneficiaries](/api/tag/beneficiaries-deprecated/get-v1-beneficiaries.md): GET /v1/beneficiaries (listBeneficiaries, deprecated) - [Retrieve a beneficiary](/api/tag/beneficiaries-deprecated/get-v1-beneficiaries-beneficiaryid.md): GET /v1/beneficiaries/{beneficiaryId} (retrieveBeneficiary, deprecated) ## API reference: Developer - [Developer](/api/tag/developer.md): Retrieve company account information. - [List developer accounts](/api/tag/developer/get-v1-developer-accounts.md): GET /v1/developer/accounts (listDeveloperAccounts) ## API reference: Webhooks - [Webhooks](/api/tag/webhooks.md): Event payload schemas and examples. - [v1.transfer.created](/api/tag/webhooks/webhook/POST/v1.transfer.created.md): Emitted when a new transfer is created. - [v1.transfer.awaiting_funds](/api/tag/webhooks/webhook/POST/v1.transfer.awaiting-funds.md): Emitted when a transfer transitions into `awaiting_funds`. - [v1.transfer.in_review](/api/tag/webhooks/webhook/POST/v1.transfer.in-review.md): Emitted when a transfer is paused for compliance review. - [v1.transfer.info_required](/api/tag/webhooks/webhook/POST/v1.transfer.info-required.md): Emitted when the transfer requires additional customer action. - [v1.transfer.funds_received](/api/tag/webhooks/webhook/POST/v1.transfer.funds-received.md): Emitted when Nodu has received the funds and is preparing to process the transfer. - [v1.transfer.payment_submitted](/api/tag/webhooks/webhook/POST/v1.transfer.payment-submitted.md): Emitted when the funds have been dispatched to the destination and are awaiting confirmation. - [v1.transfer.payment_processed](/api/tag/webhooks/webhook/POST/v1.transfer.payment-processed.md): Emitted when the transfer has completed and funds have arrived at the destination. - [v1.transfer.undeliverable](/api/tag/webhooks/webhook/POST/v1.transfer.undeliverable.md): Emitted when Nodu could not complete the transfer (e.g. invalid destination). - [v1.transfer.returned](/api/tag/webhooks/webhook/POST/v1.transfer.returned.md): Emitted when the transfer failed after submission and funds were returned to Nodu. - [v1.transfer.refunded](/api/tag/webhooks/webhook/POST/v1.transfer.refunded.md): Emitted when funds have been returned to the original sender. - [v1.transfer.canceled](/api/tag/webhooks/webhook/POST/v1.transfer.canceled.md): Emitted when the transfer was canceled. - [v1.transfer.error](/api/tag/webhooks/webhook/POST/v1.transfer.error.md): Emitted when an unrecoverable issue occurred and manual intervention is required. - [v1.payment_channel.pending](/api/tag/webhooks/webhook/POST/v1.payment-channel.pending.md): Emitted when a payment channel begins provisioning for the customer. - [v1.payment_channel.activated](/api/tag/webhooks/webhook/POST/v1.payment-channel.activated.md): Emitted when a payment channel becomes usable for the customer. - [v1.payment_channel.suspended](/api/tag/webhooks/webhook/POST/v1.payment-channel.suspended.md): Emitted when a payment channel becomes unusable for the customer (e.g. the backing account was closed). - [v1.customer.created](/api/tag/webhooks/webhook/POST/v1.customer.created.md): Emitted when a new customer is created. - [v1.customer.tos_accepted](/api/tag/webhooks/webhook/POST/v1.customer.tos-accepted.md): Emitted when the customer accepts the Terms of Service. - [v1.customer.activated](/api/tag/webhooks/webhook/POST/v1.customer.activated.md): Emitted when the customer status transitions to `active` (ToS accepted and verification approved). - [v1.customer.suspended](/api/tag/webhooks/webhook/POST/v1.customer.suspended.md): Emitted when the customer status transitions to `suspended`. - [v1.customer.blocked](/api/tag/webhooks/webhook/POST/v1.customer.blocked.md): Emitted when the customer status transitions to `blocked`. - [v1.customer.verification_under_review](/api/tag/webhooks/webhook/POST/v1.customer.verification-under-review.md): Emitted when the customer's verification status transitions to `under_review` (documents submitted, awaiting decision). - [v1.customer.verification_awaiting_associates](/api/tag/webhooks/webhook/POST/v1.customer.verification-awaiting-associates.md): Emitted when the verification status of a business transitions to `awaiting_associates`: the business has submitted its application, and Nodu reviews it once its associates have completed their verification. - [v1.customer.verification_approved](/api/tag/webhooks/webhook/POST/v1.customer.verification-approved.md): Emitted when the customer's verification is approved. - [v1.customer.verification_resubmission_required](/api/tag/webhooks/webhook/POST/v1.customer.verification-resubmission-required.md): Emitted when the customer's verification needs additional documentation or correction. - [v1.customer.verification_permanently_rejected](/api/tag/webhooks/webhook/POST/v1.customer.verification-permanently-rejected.md): Emitted when the customer's verification is permanently rejected. - [v1.wallet.created](/api/tag/webhooks/webhook/POST/v1.wallet.created.md): Emitted when a new wallet is created. - [v1.wallet.activated](/api/tag/webhooks/webhook/POST/v1.wallet.activated.md): Emitted when the wallet status transitions to `active`. - [v1.wallet.suspended](/api/tag/webhooks/webhook/POST/v1.wallet.suspended.md): Emitted when the wallet status transitions to `suspended`. - [v1.wallet.closed](/api/tag/webhooks/webhook/POST/v1.wallet.closed.md): Emitted when the wallet status transitions to `closed`. - [v1.relay.created](/api/tag/webhooks/webhook/POST/v1.relay.created.md): Emitted when a new relay is created. - [v1.relay.activated](/api/tag/webhooks/webhook/POST/v1.relay.activated.md): Emitted when the relay status transitions to `active` and its deposit instructions become available.