Skip to main content
A funding session collects a payment from a payer and credits a Nuvion account when it settles. Your server creates the session and receives a webhook when the money arrives. Use it when the payer pays through a flow Nuvion hosts. When the payer sends money to account details you share, use account details instead.

​
Choose a funding type

See Funding sessions for a request per type.

​
Lifecycle

Subscribe to funding_sessions.updated to follow a session. Credit your own records only when you have retrieved the session and seen status: "settled". See Confirm state before acting.

​
Rules that affect your integration

  • The account must exist in the session currency. A session for a currency the entity has no account in returns 404 error_resource_not_found for the account.
  • Checkout URLs come back on create. checkout_url is returned on create for open-banking and crypto. A retrieve returns it for open-banking only, so store it when you create the session.
  • Idempotency. unique_reference is the idempotency key for the session.
  • Failure codes are not exhaustive. Codes come from the payment provider and can use either letter case, for example SESSION_EXPIRED.
  • Sandbox funding. Only GBP and EUR Open Banking sessions credit an account in the sandbox. See Sandbox and testing.

​
Next steps