{"templateId":"markdown","versions":[{"version":"v0-beta","label":"Beta (v0)","link":"/products/native-api/docs/guides/foundations","default":true,"active":true,"folderId":"e4cb5a06"}],"sharedDataIds":{"sidebar":"sidebar-products/native-api/@v0-beta/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards","card"]},"type":"markdown"},"seo":{"title":"Integration Guide","description":"Official Banxa API documentation – on-ramp and off-ramp transfers with identity verification and compliance.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integration-guide","__idx":0},"children":["Integration Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every Banxa Native integration shares the same core steps: establish an identity, get a price, check eligibility, then execute payment. The payment method guides — bank transfer, Apple Pay, Google Pay, cards — each pick up from where this page leaves off."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read this page once. Then follow the guide for your payment method."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HMAC API credentials"]}," — API key and secret from the Merchant Dashboard. Required for all server-to-server calls."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A backend"]}," — all Native API calls use server-to-server HMAC authentication. Client-side API calls are not supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityReference"]}," strategy"]}," — a stable per-user identifier that you own. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/identity-reference"},"children":["Choosing an identityReference"]}," before proceeding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The Banxa React Native SDK"]}," — required for card, Apple Pay, and Google Pay payments. Not required for bank transfers."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Install the SDK and its peer dependencies:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm install @banxa-official/react-native-sdk @primer-io/react-native react-native-webview\ncd ios && pod install\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Initialise the SDK once at app startup:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import { Banxa } from '@banxa-official/react-native-sdk';\n\nconst banxa = new Banxa({\n apiKey: 'YOUR_API_KEY',\n partner: 'your-partner-id',\n environment: 'sandbox', // or 'production'\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For full SDK configuration options, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/sdk/sdk-reference"},"children":["React Native SDK Reference"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"two-integration-approaches","__idx":2},"children":["Two integration approaches"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before diving into the steps below, decide how much of the flow you want to own. This guide documents the full control approach — steps 1–4 below apply to that path."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"full-control","__idx":3},"children":["Full control"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your backend handles identity, pricing, and eligibility before payment is invoked. You call the SDK only at the payment step. Any screens for collecting KYC requirements are yours — your design, your brand, your UX."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the recommended approach for most Banxa Native integrations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quick-start","__idx":4},"children":["Quick start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createOrderAndShowPrimerCheckout"]}," without running eligibility first. The SDK creates the order and Banxa routes the user automatically: verified users go directly to the native payment sheet; users who need KYC are routed to a Banxa-hosted WebView where Banxa handles verification."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"const result = await banxa.buy.createOrderAndShowPrimerCheckout(orderRequest, {\n paymentMethod: 'applePay', // 'card' | 'applePay' | 'googlePay'\n callbacks: {\n onCheckoutComplete: () => { /* payment succeeded */ },\n onError: (error) => { /* payment failed or unavailable */ },\n onDismiss: () => { /* user dismissed */ },\n },\n});\n\nif (isPrimerCheckoutWebViewResult(result)) {\n // Banxa routed to hosted WebView (KYC required or payment method unavailable natively)\n // render \n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The trade-off: Banxa runs eligibility internally and you don't see the result. If the user needs KYC, it happens in Banxa's WebView — outside your product."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use quick start when you want the simplest possible path to a working integration — for example, during early development — or when you're explicitly comfortable with Banxa handling KYC for users who need it. It is available for the React Native SDK only. If you choose this path, skip steps 3 and 4 below."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--establish-an-identityreference","__idx":5},"children":["Step 1 — Establish an identityReference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create an identity record for the user before checking eligibility. The minimum required field is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityReference"]}," — include any personal details you already have, as they reduce the likelihood of requirements being returned at eligibility."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /eapi/v0/identities/basic\nContent-Type: application/json\n\n{\n \"identityReference\": \"partner-abc123\",\n \"email\": \"user@example.com\",\n \"dateOfBirth\": \"1990-01-15\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For returning users, reuse the existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityReference"]},". If you don't have it stored, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/identity-reference"},"children":["Choosing an identityReference"]}," for retrieval options and all new-user flow variants."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Never recreate an identity"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you attempt to create an identity for an email that already exists in Banxa, you will receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["81"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"This identity exists for this reference or email address.\""]}," Do not retry the creation. Instead, retrieve the existing identity using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /eapi/v0/identities/{identityReference}?email=user@example.com"]}," — Banxa returns the actual ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityReference"]}," linked to that email, regardless of what value you supply in the path parameter."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you verify users with Sumsub, share the verification token at this point. Token sharing satisfies ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NAME"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOB"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELFIE"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOCUMENT"]}," requirements upfront so eligibility is more likely to return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReady: true"]}," on the first check. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/kyc-token-sharing"},"children":["KYC Token Sharing"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--get-pricing","__idx":6},"children":["Step 2 — Get pricing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two pricing endpoints:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Rate locked?"},"children":["Rate locked?"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Expiry to manage?"},"children":["Expiry to manage?"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /eapi/v0/price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /eapi/v0/quote"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteId"]}," with 3-minute TTL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide uses indicative pricing. It can be called at any point in the flow and has no expiry to handle. The trade-off is that the rate is not locked — if you display a price and then create the ramp without refreshing, the rate may have moved and the user receives a different amount than shown. Refresh the price close to ramp creation to minimise the gap."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The locked quote (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /eapi/v0/quote"]},") eliminates this risk but is only supported for bank transfer ramp creation — the React Native SDK and Embedded Payment Button do not accept a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quoteId"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /eapi/v0/price?fiat=AUD&crypto=USDT&blockchain=TRON&method=payid-bank-transfer&transactionType=ONRAMP&fiatAmount=500\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiatAmount"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cryptoAmount"]}," — not both. If you're building a bank transfer integration and want to lock the rate shown on the confirmation screen, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/quotes-and-pricing"},"children":["Pricing & Quote ID"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3--check-eligibility","__idx":7},"children":["Step 3 — Check eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before every transaction, confirm the user is cleared to proceed. Eligibility evaluates the user's identity state against the transaction context — amount, payment method, and jurisdiction."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /eapi/v0/identities/transactions/eligibility\nContent-Type: application/json\n\n{\n \"identityReference\": \"partner-abc123\",\n \"method\": \"payid-bank-transfer\",\n \"transactionType\": \"ONRAMP\",\n \"fiat\": \"AUD\",\n \"crypto\": \"USDT\",\n \"blockchain\": \"TRON\",\n \"fiatAmount\": \"500\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response: cleared to proceed"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"paymentReady\": true,\n \"requirements\": []\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response: additional information required"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"paymentReady\": false,\n \"requirements\": [\"OCCUPATION\", \"SOURCE_FUNDS\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not create a ramp or invoke the SDK when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReady"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/interpreting-eligibility"},"children":["Interpreting Eligibility"]}," for the full requirements dictionary."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4--handle-requirements-if-any","__idx":8},"children":["Step 4 — Handle requirements (if any)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When eligibility returns requirements, collect the missing information in your UX and submit it before re-checking."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For structured fields (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NAME"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOB"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ADDRESS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OCCUPATION"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SOURCE_FUNDS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PURPOSE_OF_TX"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TIN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOCUMENT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POA"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PATCH /eapi/v0/identities\nContent-Type: application/json\n\n{\n \"identityReference\": \"partner-abc123\",\n \"email\": \"user@example.com\",\n \"occupationIndustry\": \"Consulting, IT, or business services\",\n \"occupation\": \"IT developer\",\n \"sourceOfFunds\": \"Salary\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," is required on every PATCH request. Partial updates are supported — include only the fields you're updating."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SELFIE"]}," — complete KYC provider token sharing first. Token sharing may satisfy multiple requirements in a single call. Then submit any remaining structured fields via PATCH. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/how-it-works/kyc-token-sharing"},"children":["KYC Token Sharing"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After submitting, re-run eligibility. Repeat until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReady: true"]},"."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n A[POST /eligibility] --> B{paymentReady?}\n B -->|true| C([Proceed to payment])\n B -->|false| D[Collect requirements in your UX]\n D --> E{SELFIE required?}\n E -->|Yes| F[POST /identities/share/token\\nKYC token sharing]\n E -->|No| G[PATCH /identities\\nStructured fields]\n F --> G\n G --> A\n","diagramHtml":"

true

false

Yes

No

POST /eligibility

paymentReady?

Proceed to payment

Collect requirements in your UX

SELFIE required?

POST /identities/share/token
KYC token sharing

PATCH /identities
Structured fields

","diagramHtmlDark":"

true

false

Yes

No

POST /eligibility

paymentReady?

Proceed to payment

Collect requirements in your UX

SELFIE required?

POST /identities/share/token
KYC token sharing

PATCH /identities
Structured fields

"},"children":["flowchart TD\n A[POST /eligibility] --> B{paymentReady?}\n B -->|true| C([Proceed to payment])\n B -->|false| D[Collect requirements in your UX]\n D --> E{SELFIE required?}\n E -->|Yes| F[POST /identities/share/token\\nKYC token sharing]\n E -->|No| G[PATCH /identities\\nStructured fields]\n F --> G\n G --> A\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5--execute-payment","__idx":9},"children":["Step 5 — Execute payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentReady: true"]}," is confirmed, proceed to your payment method guide for the execution step:"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":3,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Bank Transfer","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/native-api/docs/guides/bank-transfer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fully API-driven. No SDK required. Banxa returns funding instructions for the user to complete the transfer."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Apple Pay","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/native-api/docs/guides/apple-pay"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Native payment sheet via React Native SDK, or Embedded Payment Button for web apps. Requires platform setup."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Google Pay","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/native-api/docs/guides/google-pay"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Native payment sheet via React Native SDK, or Embedded Payment Button for web apps. Requires app-level approval for the SDK path."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Cards","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/products/native-api/docs/guides/cards"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Primer card input drawer via React Native SDK. Requires 3DS SDK setup."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tracking-transaction-status","__idx":10},"children":["Tracking transaction status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transactions are asynchronous. Configure a webhook endpoint to receive status updates:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"order_id\": \"b7f1ffbb2f1bd7a5e2ba152b4049d234\",\n \"status\": \"COMPLETED\",\n \"status_date\": \"2026-04-17 03:45:00\",\n \"external_reason\": \"...\",\n \"fiat_currency\": \"AUD\",\n \"fiat_amount\": \"500.00\",\n \"crypto_coin\": \"USDT\",\n \"crypto_amount\": \"324.51\",\n \"transaction_hash\": \"0x...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Acknowledge every webhook with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response immediately, then process asynchronously. You can also poll directly using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /eapi/v0/ramps/{id}"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/native-api/docs/transaction-lifecycle/webhooks"},"children":["Webhooks"]}," for the full payload schema and status values."]}]},"headings":[{"value":"Integration Guide","id":"integration-guide","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Two integration approaches","id":"two-integration-approaches","depth":2},{"value":"Full control","id":"full-control","depth":3},{"value":"Quick start","id":"quick-start","depth":3},{"value":"Step 1 — Establish an identityReference","id":"step-1--establish-an-identityreference","depth":2},{"value":"Step 2 — Get pricing","id":"step-2--get-pricing","depth":2},{"value":"Step 3 — Check eligibility","id":"step-3--check-eligibility","depth":2},{"value":"Step 4 — Handle requirements (if any)","id":"step-4--handle-requirements-if-any","depth":2},{"value":"Step 5 — Execute payment","id":"step-5--execute-payment","depth":2},{"value":"Tracking transaction status","id":"tracking-transaction-status","depth":2}],"frontmatter":{"title":"Integration Guide","description":"The common steps every Banxa Native integration shares — identity, pricing, eligibility, and payment execution. Read this before following a payment method guide.","seo":{"title":"Integration Guide"}},"lastModified":"2026-06-02T04:24:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/native-api/docs/guides/foundations","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}