{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"KYC workflow | xMoney Card Issuing","description":"Complete customer KYC before issuing cards through xMoney Card Issuing.","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":"kyc-workflow","__idx":0},"children":["KYC workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["KYC must be completed before customers can use regulated issuing features. xMoney coordinates the KYC state machine and hosted verification providers while your app collects required customer data and redirects the customer to hosted checks."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-kyc-status","__idx":1},"children":["Check KYC status"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://issuing-stage.xmoney.com/v1/kyc\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the response to decide which onboarding step to show next."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"submit-data-steps","__idx":2},"children":["Submit data steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit the required KYC data through the customer-scoped KYC routes:"]},{"$$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":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agreements"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/agreement"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Personal information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/personal-info"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Residence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/residence"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gender"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/gender"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Birthplace"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/birthplace"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wealth and income"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/wealth-and-income"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PEP declaration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/pep"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PEP confirmation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/kyc/confirm-pep"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"start-hosted-verification","__idx":3},"children":["Start hosted verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start identity verification:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/kyc/id-verification/start\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start proof-of-address verification:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/kyc/poa-verification/start\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The customer completes the hosted verification flow. xMoney receives the verification results and updates the KYC status."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"wait-for-approval","__idx":4},"children":["Wait for approval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["KYC can require automated or manual review. Poll ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/kyc"]}," while the customer is actively onboarding, and use webhooks to keep your backend state synchronized."]}]},"headings":[{"value":"KYC workflow","id":"kyc-workflow","depth":1},{"value":"Check KYC status","id":"check-kyc-status","depth":2},{"value":"Submit data steps","id":"submit-data-steps","depth":2},{"value":"Start hosted verification","id":"start-hosted-verification","depth":2},{"value":"Wait for approval","id":"wait-for-approval","depth":2}],"frontmatter":{"seo":{"title":"KYC workflow | xMoney Card Issuing","description":"Complete customer KYC before issuing cards through xMoney Card Issuing."}},"lastModified":"2026-07-13T21:54:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/card-issuing/kyc","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}