{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Get started | xMoney Card Issuing","description":"Learn the end-to-end card issuing flow for xMoney whitelabel partners.","llmstxt":{"hide":false,"title":"xMoney Documentation","description":"Guides and API references for integrating xMoney card and crypto payments.","sections":[{"title":"Guides","description":"Integration guides for card payments, crypto, checkout, and dashboard.","includeFiles":["guides/**/*.md"],"excludeFiles":[]},{"title":"Card API","description":"REST API reference and concepts for xMoney card payments.","includeFiles":["api/**/*.md","api/**/*.yaml"],"excludeFiles":[]},{"title":"Crypto API","description":"REST API reference and concepts for xMoney crypto payments.","includeFiles":["crypto_api/**/*.md","crypto_api/**/*.yaml"],"excludeFiles":[]},{"title":"Card Issuing API","description":"Guides and API reference for xMoney whitelabel card issuing partners.","includeFiles":["card_issuing_api/**/*.md","card_issuing_api/**/*.yaml"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"get-started-with-card-issuing","__idx":0},"children":["Get started with Card Issuing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["xMoney Card Issuing is a whitelabel service for partners that want to offer payment cards and financial accounts inside their own product. The partner owns the customer relationship and user experience, while xMoney provides the regulated account, KYC, card issuing, funding, transaction, and 3D Secure infrastructure."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide covers the standard customer card issuing flow for a whitelabel card program."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A partner identifier or partner API key from xMoney, depending on the onboarding method used by your integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card product IDs available for your card program."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A webhook URL and signing secret configured with xMoney."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Staging and production API base URLs assigned to your integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A tested customer onboarding flow for KYC and account creation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"end-to-end-flow","__idx":2},"children":["End-to-end flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart TD\n partnerSetup[\"Partner setup\"] --> registerCustomer[\"Register customer\"]\n registerCustomer --> authenticateCustomer[\"Authenticate customer\"]\n authenticateCustomer --> completeKyc[\"Complete KYC\"]\n completeKyc --> createAccount[\"Create account\"]\n createAccount --> issueCard[\"Issue card\"]\n issueCard --> fundAccount[\"Fund account\"]\n fundAccount --> transact[\"Use card\"]\n transact --> handle3ds[\"Handle 3D Secure\"]\n handle3ds --> monitor[\"Monitor transactions and webhooks\"]\n","diagramHtml":"

Partner setup

Register customer

Authenticate customer

Complete KYC

Create account

Issue card

Fund account

Use card

Handle 3D Secure

Monitor transactions and webhooks

","diagramHtmlDark":"

Partner setup

Register customer

Authenticate customer

Complete KYC

Create account

Issue card

Fund account

Use card

Handle 3D Secure

Monitor transactions and webhooks

"},"children":["flowchart TD\n partnerSetup[\"Partner setup\"] --> registerCustomer[\"Register customer\"]\n registerCustomer --> authenticateCustomer[\"Authenticate customer\"]\n authenticateCustomer --> completeKyc[\"Complete KYC\"]\n completeKyc --> createAccount[\"Create account\"]\n createAccount --> issueCard[\"Issue card\"]\n issueCard --> fundAccount[\"Fund account\"]\n fundAccount --> transact[\"Use card\"]\n transact --> handle3ds[\"Handle 3D Secure\"]\n handle3ds --> monitor[\"Monitor transactions and webhooks\"]\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"main-api-areas","__idx":3},"children":["Main API areas"]},{"$$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":"Area"},"children":["Area"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Main routes"},"children":["Main routes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/auth/register/partner"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/auth/login/partner"]},", email and wallet auth routes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/kyc"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/kyc/agreement"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/kyc/personal-info"]},", hosted ID and POA verification starts"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accounts"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/accounts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/accounts/{accountId}/close"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cards"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/cards"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/cards/{id}/freeze"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/cards/{id}/unfreeze"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/cards/{id}/reissue/{reason}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Funding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/topups"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/topups/fiat"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/topups/crypto/*"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transactions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/transactions"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/transactions/3d-secure"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/transactions/{transactionId}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Webhooks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kycStatusChanged"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardStatusChanged"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction3dsRequested"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction3dsCompleted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionCreated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionSettled"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topupCreated"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topupStatusChanged"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommended-integration-sequence","__idx":4},"children":["Recommended integration sequence"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Register or identify the customer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authenticate the customer and store the returned access and refresh tokens securely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete KYC data collection and hosted verification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the customer account for the card currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Issue a virtual or physical card using the card product assigned to your program."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fund the account with fiat or crypto topups."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use transaction and webhook events to keep your app state synchronized."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Continue with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/card-issuing/customer-onboarding"},"children":["Customer onboarding"]},"."]}]},"headings":[{"value":"Get started with Card Issuing","id":"get-started-with-card-issuing","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"End-to-end flow","id":"end-to-end-flow","depth":2},{"value":"Main API areas","id":"main-api-areas","depth":2},{"value":"Recommended integration sequence","id":"recommended-integration-sequence","depth":2}],"frontmatter":{"seo":{"title":"Get started | xMoney Card Issuing","description":"Learn the end-to-end card issuing flow for xMoney whitelabel partners."}},"lastModified":"2026-07-09T17:49:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/card-issuing/get-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}