{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Accounts, cards, and funding | xMoney Card Issuing","description":"Create accounts, issue cards, and fund card programs with fiat or crypto topups.","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":"accounts-cards-and-funding","__idx":0},"children":["Accounts, cards, and funding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a customer is authenticated and KYC-approved, create the customer account, issue a card, and fund the account. The card issuing product is delivered as a whitelabel service, so the partner controls the user experience while xMoney handles account and card infrastructure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-an-account","__idx":1},"children":["Create an account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List existing accounts:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://issuing-stage.xmoney.com/v1/accounts?currency=EUR\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create an account for the required card currency:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/accounts\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\" \\\n  -d '{\n    \"currency\": \"EUR\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Close an account only when it is no longer needed:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/accounts/ACCOUNT_ID/close\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"issue-a-card","__idx":2},"children":["Issue a card"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the subscription card product assigned to your program."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/cards\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\" \\\n  -d '{\n    \"subscriptionCardId\": \"123e4567-e89b-12d3-a456-426614174000\",\n    \"isVirtual\": true,\n    \"currency\": \"EUR\",\n    \"label\": \"Main card\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For physical cards, include the required delivery fields and PIN."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List issued cards:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://issuing-stage.xmoney.com/v1/cards\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"card-lifecycle","__idx":3},"children":["Card lifecycle"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these routes to manage card state:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/cards/{id}/freeze"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/cards/{id}/unfreeze"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/cards/{id}/reissue/{reason}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/cards/{id}/secrets"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/cards/{id}/provisioning/apple-pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/cards/{id}/provisioning/google-pay"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve sensitive card secrets only when needed, and never log or store PAN, CVV, PIN, or wallet provisioning secrets longer than required for the user action."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fiat-funding","__idx":4},"children":["Fiat funding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a fiat topup order:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/topups/fiat\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\" \\\n  -d '{\n    \"amount\": \"100.00\",\n    \"currency\": \"EUR\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is HTML for the hosted payment processor flow. Present or redirect the customer according to the returned form."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"crypto-funding","__idx":5},"children":["Crypto funding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the crypto topup routes to list supported assets, check limits, quote rates and fees, then create the topup order."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://issuing-stage.xmoney.com/v1/topups/crypto/currencies\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check limits for a specific asset:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://issuing-stage.xmoney.com/v1/topups/crypto/limits?blockchain=multiversx&identifier=EGLD\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get an exchange-rate quote:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/topups/crypto/exchange-rate\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\" \\\n  -d '{\n    \"fiatCurrency\": \"EUR\",\n    \"cryptoCurrency\": \"EGLD\",\n    \"amount\": 10,\n    \"inputType\": \"fiat\",\n    \"blockchain\": \"multiversx\",\n    \"senderAddress\": \"erd1exampleaddress\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the topup order with the same quote input shape:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://issuing-stage.xmoney.com/v1/topups/crypto\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer CUSTOMER_ACCESS_TOKEN\" \\\n  -d '{\n    \"fiatCurrency\": \"EUR\",\n    \"cryptoCurrency\": \"EGLD\",\n    \"amount\": 10,\n    \"inputType\": \"fiat\",\n    \"blockchain\": \"multiversx\",\n    \"senderAddress\": \"erd1exampleaddress\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Track topups with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/topups?page=1&size=20"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/topups/{id}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/topups/limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/topups/usage"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/topups"]}," can also filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},"."]}]},"headings":[{"value":"Accounts, cards, and funding","id":"accounts-cards-and-funding","depth":1},{"value":"Create an account","id":"create-an-account","depth":2},{"value":"Issue a card","id":"issue-a-card","depth":2},{"value":"Card lifecycle","id":"card-lifecycle","depth":2},{"value":"Fiat funding","id":"fiat-funding","depth":2},{"value":"Crypto funding","id":"crypto-funding","depth":2}],"frontmatter":{"seo":{"title":"Accounts, cards, and funding | xMoney Card Issuing","description":"Create accounts, issue cards, and fund card programs with fiat or crypto topups."}},"lastModified":"2026-07-13T21:54:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/card-issuing/accounts-cards-and-funding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}