{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Network Token Payments | xMoney Documentation","description":"Learn how to submit network token payments with xMoney.","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":"network-token-payments","__idx":0},"children":["Network Token Payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Network token payments let you authorize a card payment with a scheme token instead of the customer’s primary account number. Use this flow when your payment stack receives a tokenized card credential from a token service provider, issuer, wallet, or payment orchestration platform."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-this-flow","__idx":1},"children":["When to use this flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use network token payments when you can provide:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A network token, also known as a DPAN."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The token expiry date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A token cryptogram, such as a TAVV or DSRP cryptogram, when supplied by the token service provider or wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["3D Secure authentication values, such as CAVV and ECI, when your authentication flow produced them."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Apple Pay and Google Pay integrations where you receive a decrypted external payment network payload, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payments/decrypted-wallet-payloads"},"children":["Decrypted wallet payloads"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-fields","__idx":2},"children":["Request fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send network token payments through ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/reference/order/create-an-order"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /order"]}]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionMethod"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]},"."]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"right","data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token scheme or token service provider. Accepted values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MDES"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VTS"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APPLE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GOOGLE"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SAMSUNG"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkToken"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The network token value, also known as the DPAN. Send 12 to 19 digits. Spaces and dashes are ignored."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token expiry date in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MM/YY"]}," format."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenCryptogram"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token cryptogram. Send TAVV or DSRP cryptograms in this field when available."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenEci"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Electronic Commerce Indicator associated with the network token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cavv"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cardholder Authentication Verification Value from a 3D Secure authentication. This is separate from the token cryptogram."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3D Secure ECI value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3D Secure transaction identifier, when available."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDSProtocolVersion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3D Secure protocol version, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2.2.0"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["threeDsType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"right"},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication type or result classification from your 3D Secure provider."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardId"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenType"]},". A network token payment uses the supplied DPAN and cryptogram data instead of a saved xMoney card token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardCvv"]}," is not required for network token payments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cryptogram-mapping","__idx":3},"children":["Cryptogram mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Different partners and token providers use different names for cryptograms. In xMoney requests, map them as follows:"]},{"$$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":"Partner or network term"},"children":["Partner or network term"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"xMoney field"},"children":["xMoney field"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network token, DPAN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkToken"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TAVV"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenCryptogram"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DSRP cryptogram"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenCryptogram"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token ECI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTokenEci"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CAVV"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cavv"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3DS ECI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have both a token cryptogram and CAVV, send both. They represent different parts of the authorization context."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request","__idx":4},"children":["Example request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-stage.xmoney.com/order\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application/x-www-form-urlencoded\" \\\n  -d \"amount=10.00\" \\\n  -d \"currency=EUR\" \\\n  -d \"orderType=purchase\" \\\n  -d \"customerId=12345\" \\\n  -d \"transactionMethod=card\" \\\n  -d \"cardTransactionMode=authAndCapture\" \\\n  -d \"cardExpiryDate=12/28\" \\\n  -d \"networkTokenType=VTS\" \\\n  -d \"networkToken=4111111111111111\" \\\n  -d \"networkTokenCryptogram=AgAAAAAAAIR8CQrXcIhbQAAAAAA=\" \\\n  -d \"networkTokenEci=05\" \\\n  -d \"cavv=AkZO5XQAA0rhBxoaufa+MAABAAA=\" \\\n  -d \"eci=05\" \\\n  -d \"ip=203.0.113.10\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-response","__idx":5},"children":["Example response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The create order response uses the standard order response structure. If the payment requires a redirect or 3D Secure step, the response includes redirect details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 201,\n  \"message\": \"Created\",\n  \"data\": {\n    \"orderId\": 67890,\n    \"transactionId\": 123456,\n    \"is3d\": 0,\n    \"isRedirect\": false\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"network-transaction-id","__idx":6},"children":["Network transaction ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For standard xMoney stored-card payments, you do not need to send these fields. xMoney handles card tokenization and the required merchant-initiated transaction data internally."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the original scheme reference only when tokenization happens outside xMoney and your integration is responsible for chaining subsequent stored-credential or merchant-initiated payments:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTransactionId"]},": the network transaction identifier from the original transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["networkTransactionDate"]},": the original transaction date as a Unix timestamp in milliseconds."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These fields are optional. If you send one of them, both fields must be supplied together. To retrieve the network transaction ID returned by the provider, call ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/reference/transaction/retrieve-a-transaction"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /transaction/{id}"]}]}," and read ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.components[].providerNetworkTransactionId"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payments/recurring-payments"},"children":["Recurring payments"]}," for more on merchant-initiated payment flows."]}]},"headings":[{"value":"Network Token Payments","id":"network-token-payments","depth":1},{"value":"When to use this flow","id":"when-to-use-this-flow","depth":2},{"value":"Request fields","id":"request-fields","depth":2},{"value":"Cryptogram mapping","id":"cryptogram-mapping","depth":2},{"value":"Example request","id":"example-request","depth":2},{"value":"Example response","id":"example-response","depth":2},{"value":"Network transaction ID","id":"network-transaction-id","depth":2}],"frontmatter":{"seo":{"title":"Network Token Payments | xMoney Documentation","description":"Learn how to submit network token payments with xMoney."}},"lastModified":"2026-06-25T12:10:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payments/network-token-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}