{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/products/card-payouts/v1/payouts","default":false,"active":false,"folderId":"c6ff1dc0"},{"version":"v2","label":"v2","link":"/products/card-payouts/v2/payouts","default":false,"active":false,"folderId":"c6ff1dc0"},{"version":"v3","label":"v3","link":"/products/card-payouts/v3/payouts","default":false,"active":false,"folderId":"c6ff1dc0"},{"version":"v4","label":"v4 (Latest)","link":"/products/card-payouts/payouts","default":true,"active":true,"folderId":"c6ff1dc0"}],"sharedDataIds":{"sidebar":"sidebar-products/card-payouts/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/card-payouts/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","tabs","tab","code-snippet","json-schema"]},"custom_product":"Card Payouts","type":"markdown"},"seo":{"title":"Make a card payout","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 06 March 2026 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"make-a-card-payout","__idx":0},"children":["Make a card payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send funds to your customer's cards."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"standard-payout","__idx":1},"children":["Standard payout"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-request","__idx":2},"children":["Payout request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pay your customers by sending a request to our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:basicDisbursement"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/get-started#query-the-payouts-root-resource"},"children":["query the payout root resource"]}," request."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to payout to a wallet please read ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/wallets"},"children":["here"]}," first."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/payouts/basicDisbursement"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout request body:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Standard payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/plain\",\n            \"cardHolderName\": \"Sherlock Holmes\",\n            \"cardNumber\": \"4444333322221111\",\n            \"cardExpiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            },\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Token/wallet payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/tokenized\",\n            \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoiMjZ5OUp3Q2dEeDVjWEZBcjhjSmRlcmZTcE44ZzRoazFMcmNCSzlqaEVWcz0ifQ\"\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay decrypted payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-decrypted-applepay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/networkToken+applepay\",\n            \"cardHolderName\": \"Sherlock Holmes\",\n            \"dpan\": \"4444333322221111\",\n            \"cardExpiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            },\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Network token payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-network-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n   \"instruction\": {\n       \"value\": {\n           \"amount\": 100,\n           \"currency\": \"GBP\"\n       },\n       \"payoutInstrument\": {\n           \"type\": \"card/networkToken\",\n           \"cardHolderName\": \"Sherlock Holmes\",\n           \"expiryDate\": {\n               \"month\": 12,\n               \"year\": 2029\n           },\n           \"tokenNumber\": \"5555555555554444\",\n           \"billingAddress\": {\n           \"address1\":\"address1\",\n            \"address2\":\"address2\",\n            \"address3\":\"address3\",\n            \"postalCode\":\"AB1 2CD\",\n            \"city\":\"city\",\n            \"state\":\"state\",\n            \"countryCode\":\"GB\"\n            }\n       },\n       \"narrative\": {\n       \"line1\":\"test1\",\n       \"line2\": \"test2\"\n      } \n   },\n   \"merchant\": {\n       \"entity\": \"default\"\n   },\n   \"transactionReference\": \"{{$guid}}\"\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-schema","__idx":3},"children":["Payout schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"openapi.yaml#/components/schemas/payouts_basicDisbursement"},"options":{"schemaExpansionLevel":0},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/payouts_basicDisbursement"},"card_plain":{"required":["type","cardNumber","cardExpiryDate"],"type":"object","description":"Plain card details.","properties":{"type":{"type":"string"},"cardNumber":{"type":"string","description":"Your customer's payout card number.","maxLength":19,"minLength":12,"pattern":"^[0-9]*$"},"cardExpiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of your customer's card. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"cardHolderName":{"type":"string","pattern":"^(?=.*[A-Za-z])[-A-Za-z0-9_ ]*$","description":"The name on your customer's card. This is a mandatory field for US domiciled merchants only, however it is recommended that you supply this to improve authorization rates. If not supplied, the default is \"Not Supplied\". Must not contain only numeric characters."},"billingAddress":{"required":["countryCode","postalCode"],"type":"object","description":"An object containing the billing address information. This is a mandatory field for US domiciled merchants only, however we recommend you provide `billingAddress` fields for all Payout requests.","properties":{"countryCode":{"type":"string","description":"Must be provided in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."},"postalCode":{"type":"string"},"address1":{"type":"string","description":"First line of the address. Required if `city` is provided."},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":"City. Required if `address1` is provided."},"state":{"type":"string","description":"Billing contact state code.\n\n * For North America, you must use the two-letter state abbreviations as defined in the latter part of the [ISO 3166-2 standard](https://www.iso.org/obp/ui/#iso:code:3166:US).\n * For all other regions and provinces around the world, this is a free text field.\n\n Example:\n\n * `AZ`\n\n * `Cambridgeshire`"}}}}},"card_tokenized":{"required":["type","href"],"type":"object","description":"Tokenized card details.","properties":{"type":{"type":"string"},"href":{"type":"string","description":"An object that contains your link to an Access Token."}}},"card_networkToken":{"required":["type","tokenNumber","expiryDate"],"type":"object","description":"Network Payment Token details.","properties":{"type":{"type":"string"},"tokenNumber":{"type":"string","description":"The network payment token number.","maxLength":19,"minLength":12,"pattern":"^[0-9]*$","example":"4444333322221111"},"expiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of the network token. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}}}},"applepay_decrypted":{"required":["type","dpan","cardExpiryDate"],"type":"object","description":"Wallet details.","properties":{"type":{"type":"string"},"dpan":{"type":"string","description":"The device primary account number (DPAN).","maxLength":19,"minLength":12,"pattern":"^[0-9]*$","example":"4444333322221111"},"cardExpiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of the payout DPAN. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"billingAddress":{"required":["countryCode","postalCode"],"type":"object","description":"An object containing the billing address information. This is a mandatory field for US domiciled merchants only, however we recommend you provide `billingAddress` fields for all Payout requests.","properties":{"countryCode":{"type":"string","description":"Must be provided in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."},"postalCode":{"type":"string"},"address1":{"type":"string","description":"First line of the address. Required if `city` is provided."},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":"City. Required if `address1` is provided."},"state":{"type":"string","description":"Billing contact state code.\n\n * For North America, you must use the two-letter state abbreviations as defined in the latter part of the [ISO 3166-2 standard](https://www.iso.org/obp/ui/#iso:code:3166:US).\n * For all other regions and provinces around the world, this is a free text field.\n\n Example:\n\n * `AZ`\n\n * `Cambridgeshire`"}}},"cardHolderName":{"type":"string","pattern":"^(?=.*[A-Za-z])[-A-Za-z0-9_ ]*$","description":"The name on your customer's card. This is a mandatory field for US domiciled merchants only, however it is recommended that you supply this to improve authorization rates. If not supplied, the default is \"Not Supplied\". Must not contain only numeric characters."}}},"payouts_basicDisbursement":{"required":["instruction","merchant","transactionReference"],"type":"object","description":"Basic disbursement input.","properties":{"instruction":{"required":["narrative","payoutInstrument","value"],"type":"object","description":"An object that contains all the information related to your payout request.","properties":{"narrative":{"required":["line1"],"type":"object","description":"An object that contains identification and further details of the merchant.","properties":{"line1":{"type":"string","description":"First line of text that appears on your customer's statement."},"line2":{"type":"string","description":"Second line of text that appears on your customer's statement."}}},"payoutInstrument":{"type":"object","description":"An object that contains your customer's payout type.","oneOf":[{"$ref":"#/components/schemas/card_plain"},{"$ref":"#/components/schemas/card_tokenized"},{"$ref":"#/components/schemas/card_networkToken"},{"$ref":"#/components/schemas/applepay_decrypted"}],"discriminator":{"propertyName":"type","mapping":{"card/plain":"#/components/schemas/card_plain","card/tokenized":"#/components/schemas/card_tokenized","card/networkToken":"#/components/schemas/card_networkToken","card/networkToken+applepay":"#/components/schemas/applepay_decrypted"}}},"value":{"required":["amount","currency"],"type":"object","description":"An object that contains payout amount and currency.","properties":{"amount":{"type":"integer","description":"The payout amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50.","example":250},"currency":{"type":"string","description":"The three character currency code. See list of [supported currencies](/products/reference/supported-countries-currencies#iso-currency-codes).","example":"USD"}}}}},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant.","properties":{"entity":{"maxLength":32,"minLength":1,"pattern":"^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$","example":"default","type":"string","description":"Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries."}}},"transactionReference":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","description":"A unique reference generated by you, used to identify a payout throughout its lifecycle."}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-response","__idx":4},"children":["Payout response"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access Worldpay returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-correlationId"]}," in the headers of service responses. We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["highly recommend"]}," you log this. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-correlationId"]}," is used by us to examine individual service requests."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your response we return:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]},", which could be:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestReceived"]}," - We have received your basic disbursement request and are processing it within 3-5 working days."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]}," - This payout method is refused, try another card."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," -  A downstream system failed to process your request."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["a timestamp of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receivedAt"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["the location of the payout resource"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example responses:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"requestReceived","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/responses/request-received.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"requestReceived\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"refused","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/responses/refused.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"refused\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"error","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/responses/error.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"error\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend using our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/events"},"children":["Events service"]}," to receive the latest payout status."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fast-access-payouts","__idx":5},"children":["Fast Access payouts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Fast Access to pay your customers within 30 minutes or less."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Prerequisite"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must be enabled for Fast Access before using it. Please contact your Worldpay Implementation Manager for more information."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fast-access-request","__idx":6},"children":["Fast Access request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send your payout request to our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:fastAccess"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/get-started#query-the-payouts-root-resource"},"children":["query the payout root resource"]}," request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your customer's card is not Fast Access enabled, a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#standard-payout"},"children":["standard payout"]}," is automatically performed."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to payout to a wallet please read ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/wallets"},"children":["here"]}," first."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},"  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/payouts/fastAccess"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fast Access payout request body:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Fast Access payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/plain\",\n            \"cardHolderName\": \"Sherlock Holmes\",\n            \"cardNumber\": \"4444333322221111\",\n            \"cardExpiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            },\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Token payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/tokenized\",\n            \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoiMjZ5OUp3Q2dEeDVjWEZBcjhjSmRlcmZTcE44ZzRoazFMcmNCSzlqaEVWcz0ifQ\"\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay decrypted payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-decrypted-applepay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/networkToken+applepay\",\n            \"cardHolderName\": \"Sherlock Holmes\",\n            \"dpan\": \"4444333322221111\",\n            \"cardExpiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            },\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Network token payout","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-network-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n   \"instruction\": {\n       \"value\": {\n           \"amount\": 100,\n           \"currency\": \"GBP\"\n       },\n       \"payoutInstrument\": {\n           \"type\": \"card/networkToken\",\n           \"cardHolderName\": \"Sherlock Holmes\",\n           \"expiryDate\": {\n               \"month\": 12,\n               \"year\": 2029\n           },\n           \"tokenNumber\": \"5555555555554444\",\n           \"billingAddress\": {\n           \"address1\":\"address1\",\n            \"address2\":\"address2\",\n            \"address3\":\"address3\",\n            \"postalCode\":\"AB1 2CD\",\n            \"city\":\"city\",\n            \"state\":\"state\",\n            \"countryCode\":\"GB\"\n            }\n       },\n       \"narrative\": {\n       \"line1\":\"test1\",\n       \"line2\": \"test2\"\n      } \n   },\n   \"merchant\": {\n       \"entity\": \"default\"\n   },\n   \"transactionReference\": \"{{$guid}}\"\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"routing-your-fast-access-request","__idx":7},"children":["Routing your Fast Access request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where a card supports multiple card schemes, you may optionally submit a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredCardBrand"]}," in your card payout request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example: Some US-issued Visa cards also support Maestro as a debit network. This is typically indicated by Maestro appearing on the back of the card. You may optionally opt to route your payout to Mastercard in this case. By default, the transaction is routed to the primary card scheme (sometimes described as the \"front of card\" network)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheme.name"]}," in the response indicates the route that was used. If your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preferredCardBrand"]}," is not supported for the card, the transaction is automatically routed to the primary card scheme."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/testing#routing-magic-values"},"children":["testing page"]}," to test various routing outcomes."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Preferred card brand routing is only available for:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fast Access card payouts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["US domiciled merchants"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/plain"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/tokenized"]}," payout instruments",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardHolderName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAddress"]}," fields are mandatory for US domiciled merchants"]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Preferred card brand - plain card","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-mastercardPreferredCardBrand.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"routing\": {\n            \"preferredCardBrand\": \"mastercard\"\n        },\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"USD\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/plain\",\n            \"cardHolderName\": \"Sherlock Holmes\",\n            \"cardNumber\": \"4444333322221111\",\n            \"cardExpiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            },\n            \"billingAddress\": {\n                \"address1\": \"789 Palm Drive\",\n                \"address2\": \"Unit 12\",\n                \"address3\": \"Sunset Villas\",\n                \"postalCode\": \"33101\",\n                \"city\": \"Miami\",\n                \"state\": \"FL\",\n                \"countryCode\": \"US\"\n            }\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Preferred card brand - token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token-mastercardPreferredCardBrand.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"routing\": {\n            \"preferredCardBrand\": \"mastercard\"\n        },\n        \"narrative\": {\n            \"line1\": \"The Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"USD\",\n            \"amount\": 100\n        },\n        \"payoutInstrument\": {\n            \"type\": \"card/tokenized\",\n            \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoiMjZ5OUp3Q2dEeDVjWEZBcjhjSmRlcmZTcE44ZzRoazFMcmNCSzlqaEVWcz0ifQ\"\n        }\n    }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We also check whether the supplied card supports Visa Direct / Mastercard Send disbursements and by default we will fall back to a basic disbursement where we do not get a response from the scheme."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can decide whether to fall back to basic or not by sending an optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fallbackToBasic"]}," field in the routing request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fallbackToBasic"]}," to \"disabled\", instead of falling back we send an error message to you."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"fallbackToBasic - enabled","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-fallbackToBasicEnabled.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n   \"instruction\": {\n       \"value\": {\n           \"amount\": 100,\n           \"currency\": \"USD\"\n       },\n       \"routing\": {\n      \"fallbackToBasic\": \"enabled\"\n    },\n       \"payoutInstrument\": {\n           \"type\": \"card/plain\",\n           \"cardHolderName\": \"Sherlock Holmes\",\n           \"cardExpiryDate\": {\n               \"month\": 12,\n               \"year\": 2029\n           },\n           \"cardNumber\": \"5555555555554444\",\n           \"billingAddress\": {\n           \"address1\":\"789 Palm Drive\",\n            \"address2\":\"Unit 12\",\n            \"address3\":\"Sunset Villas\",\n            \"postalCode\":\"33101\",\n            \"city\":\"Miami\",\n            \"state\":\"FL\",\n            \"countryCode\":\"US\"\n            }\n       },\n       \"narrative\": {\"line1\":\"PAYOUT\"}\n   },\n   \"merchant\": {\n       \"entity\": \"default\"\n   },\n   \"transactionReference\": \"{{$guid}}\"\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"fallbackToBasic - disabled","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token-fallbackToBasicDisabled.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n   \"instruction\": {\n       \"value\": {\n           \"amount\": 100,\n           \"currency\": \"USD\"\n       },\n       \"routing\": {\n      \"fallbackToBasic\": \"disabled\"\n    },\n       \"payoutInstrument\": {\n           \"type\": \"card/plain\",\n           \"cardHolderName\": \"Sherlock Holmes\",\n           \"cardExpiryDate\": {\n               \"month\": 12,\n               \"year\": 2029\n           },\n           \"cardNumber\": \"5555555555554444\",\n           \"billingAddress\": {\n           \"address1\":\"789 Palm Drive\",\n            \"address2\":\"Unit 12\",\n            \"address3\":\"Sunset Villas\",\n            \"postalCode\":\"33101\",\n            \"city\":\"Miami\",\n            \"state\":\"FL\",\n            \"countryCode\":\"US\"\n            }\n       },\n       \"narrative\": {\"line1\":\"PAYOUT\"}\n   },\n   \"merchant\": {\n       \"entity\": \"default\"\n   },\n   \"transactionReference\": \"{{$guid}}\"\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"fallbackToBasic - disabled VisaResponse","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token-fallbackToBasicDisabledVisaResponse.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"errorName\": \"noInquiryDetailsReceivedfromVisa\",\n  \"message\": \"The card scheme didn't provide the card details during inquiry, please try again later.\"\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"fallbackToBasic - disabled MastercardResponse","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/payouts-request-token-fallbackToBasicDisabledMCResponse.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"errorName\": \"noInquiryDetailsReceivedfromMastercard\",\n  \"message\": \"The card scheme didn't provide the card details during inquiry, please try again later.\"\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fast-access-schema","__idx":8},"children":["Fast Access schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"openapi.yaml#/components/schemas/payouts_fastAccess"},"options":{"schemaExpansionLevel":0},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/payouts_fastAccess"},"card_plain":{"required":["type","cardNumber","cardExpiryDate"],"type":"object","description":"Plain card details.","properties":{"type":{"type":"string"},"cardNumber":{"type":"string","description":"Your customer's payout card number.","maxLength":19,"minLength":12,"pattern":"^[0-9]*$"},"cardExpiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of your customer's card. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"cardHolderName":{"type":"string","pattern":"^(?=.*[A-Za-z])[-A-Za-z0-9_ ]*$","description":"The name on your customer's card. This is a mandatory field for US domiciled merchants only, however it is recommended that you supply this to improve authorization rates. If not supplied, the default is \"Not Supplied\". Must not contain only numeric characters."},"billingAddress":{"required":["countryCode","postalCode"],"type":"object","description":"An object containing the billing address information. This is a mandatory field for US domiciled merchants only, however we recommend you provide `billingAddress` fields for all Payout requests.","properties":{"countryCode":{"type":"string","description":"Must be provided in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."},"postalCode":{"type":"string"},"address1":{"type":"string","description":"First line of the address. Required if `city` is provided."},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":"City. Required if `address1` is provided."},"state":{"type":"string","description":"Billing contact state code.\n\n * For North America, you must use the two-letter state abbreviations as defined in the latter part of the [ISO 3166-2 standard](https://www.iso.org/obp/ui/#iso:code:3166:US).\n * For all other regions and provinces around the world, this is a free text field.\n\n Example:\n\n * `AZ`\n\n * `Cambridgeshire`"}}}}},"card_tokenized":{"required":["type","href"],"type":"object","description":"Tokenized card details.","properties":{"type":{"type":"string"},"href":{"type":"string","description":"An object that contains your link to an Access Token."}}},"card_networkToken":{"required":["type","tokenNumber","expiryDate"],"type":"object","description":"Network Payment Token details.","properties":{"type":{"type":"string"},"tokenNumber":{"type":"string","description":"The network payment token number.","maxLength":19,"minLength":12,"pattern":"^[0-9]*$","example":"4444333322221111"},"expiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of the network token. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}}}},"applepay_decrypted":{"required":["type","dpan","cardExpiryDate"],"type":"object","description":"Wallet details.","properties":{"type":{"type":"string"},"dpan":{"type":"string","description":"The device primary account number (DPAN).","maxLength":19,"minLength":12,"pattern":"^[0-9]*$","example":"4444333322221111"},"cardExpiryDate":{"required":["month","year"],"type":"object","description":"The expiry date of the payout DPAN. Must be a date in the future.","properties":{"month":{"type":"integer"},"year":{"type":"integer"}}},"billingAddress":{"required":["countryCode","postalCode"],"type":"object","description":"An object containing the billing address information. This is a mandatory field for US domiciled merchants only, however we recommend you provide `billingAddress` fields for all Payout requests.","properties":{"countryCode":{"type":"string","description":"Must be provided in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."},"postalCode":{"type":"string"},"address1":{"type":"string","description":"First line of the address. Required if `city` is provided."},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":"City. Required if `address1` is provided."},"state":{"type":"string","description":"Billing contact state code.\n\n * For North America, you must use the two-letter state abbreviations as defined in the latter part of the [ISO 3166-2 standard](https://www.iso.org/obp/ui/#iso:code:3166:US).\n * For all other regions and provinces around the world, this is a free text field.\n\n Example:\n\n * `AZ`\n\n * `Cambridgeshire`"}}},"cardHolderName":{"type":"string","pattern":"^(?=.*[A-Za-z])[-A-Za-z0-9_ ]*$","description":"The name on your customer's card. This is a mandatory field for US domiciled merchants only, however it is recommended that you supply this to improve authorization rates. If not supplied, the default is \"Not Supplied\". Must not contain only numeric characters."}}},"payouts_fastAccess":{"required":["instruction","merchant","transactionReference"],"type":"object","description":"Fast access input.","properties":{"instruction":{"required":["narrative","payoutInstrument","value"],"type":"object","description":"An object that contains all the information related to your payout request.","properties":{"narrative":{"required":["line1"],"type":"object","description":"An object that contains identification and further details of the merchant.","properties":{"line1":{"type":"string","description":"First line of text that appears on your customer's statement."},"line2":{"type":"string","description":"Second line of text that appears on your customer's statement."}}},"payoutInstrument":{"type":"object","description":"An object that contains your customer's payout type.","required":["type"],"oneOf":[{"$ref":"#/components/schemas/card_plain"},{"$ref":"#/components/schemas/card_tokenized"},{"$ref":"#/components/schemas/card_networkToken"},{"$ref":"#/components/schemas/applepay_decrypted"}],"discriminator":{"propertyName":"type","mapping":{"card/plain":"#/components/schemas/card_plain","card/tokenized":"#/components/schemas/card_tokenized","card/networkToken":"#/components/schemas/card_networkToken","card/networkToken+applepay":"#/components/schemas/applepay_decrypted"}}},"value":{"required":["amount","currency"],"type":"object","description":"An object that contains payout amount and currency.","properties":{"amount":{"type":"integer","description":"The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50.","example":250},"currency":{"type":"string","description":" The three character currency code. See list of [supported currencies](/products/reference/supported-countries-currencies#iso-currency-codes).","example":"USD"}}},"routing":{"type":"object","properties":{"preferredCardBrand":{"type":"string","enum":["maestro","mastercard"],"description":"Specifies the preferred card brand to be used for routing the transaction, where a card supports more than one routing option. If the supplied card brand is not supported by the card payout instrument, we will route the card payout to the available route. \n Available for US-domiciled merchants only."},"fallbackToBasic":{"type":"string","enum":["disabled","enabled"],"description":"We check whether the supplied card supports Visa Direct / Mastercard Send disbursements. By default, we will fall back to a [basic disbursement](/products/card-payouts/payouts#standard-payout) where we do not get a response from the scheme. Select this option to disable this behavior and instead receive an error."}}}}},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant.","properties":{"entity":{"maxLength":32,"minLength":1,"pattern":"^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$","example":"default","type":"string","description":"Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries."}}},"transactionReference":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","description":"A unique reference generated by you, used to identify a payout throughout its lifecycle."}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full request schema is available in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payouts/openapi"},"children":["API reference"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fast-access-response","__idx":9},"children":["Fast Access response"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access Worldpay returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," in the headers of service responses. We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["highly recommend"]}," you log this. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," is used by us to examine individual service requests."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In our response we return:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a timestamp ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receivedAt"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the location of the payout resource"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["scheme name and reference for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requested"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestReceived"]}," outcomes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["refusal code for outcome ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"possible-outcomes","__idx":10},"children":["Possible outcomes"]},{"$$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":"Outcome"},"children":["Outcome"]},{"$$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":["requested"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We have received your Fast Access disbursement."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We have sent your Fast Access disbursement request to Visa Direct/Mastercard Send. If there are no updates within 48 hours then this moves to an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," outcome."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Visa/Mastercard has approved your request and the funds are allocated within 30 minutes if the issuer is Fast Access enabled. If not, standard timescales apply."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["disbursed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The transaction is reconciled with Visa/Mastercard's daily reporting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your Fast Access disbursement request is refused. Possible refusal reasons:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" the card issuer declines the disbursement"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Visa/Mastercard declines your request because the issuing bank is not responding"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["disbursements are not allowed in the requested country"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inReview"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We are reviewing your Fast Access disbursement request, but the card does not support Fast Access. If the review is successful, then your payout is processed and moves to an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refused"]}," outcome. If the review fails, the payout moves to an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," outcome"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestReceived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We have received your Fast Access disbursement request, but the card does not support Fast Access."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There is no response from Visa/Mastercard within 48 hours or Visa/Mastercard returns an error confirming the request has failed."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"outcome-examples","__idx":11},"children":["Outcome examples"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"requested","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-requested.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"requested\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"pending","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-pending.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"pending\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"approved","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-approved.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"approved\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"disbursed","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-disbursed.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"disbursed\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"refused","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-refused.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"refused\",\n    \"refusalCode\": \"9G\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"inReview","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-inReview.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"inReview\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"requestReceived","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-requestReceived.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"requestReceived\",\n    \"receivedAt\": \"2025-10-07T11:39:47.780549Z\",\n    \"scheme\": {\n        \"name\": \"mastercard\",\n        \"reference\": \"528000000610\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/MjorYjlBc3BsYkhNZmpRMEFIWWxpa1B3PT06QUVTL0NCQy9QS0NTNVBhZGRpbmc6ays2T2xBZnU0b1NBSWVRbEFFZUt2MU03SW8rYUJHNVhJeUM2NTlNWHk5VUM4cWxPdHVHTHNnTU0vR01adE5YaCtHN3RoaEdVN1JoWkpFZlJIWTdaSmRmTHNHa0lWdnJXMHdVVW5SbjJWOXM9\"\n        },\n        \"curies\": [\n            {\n                \"name\": \"payouts\",\n                \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n                \"templated\": true\n            }\n        ]\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"error","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-error.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"error\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"fast-access-payout-outcome-of-requested--pending-or-approved","__idx":12},"children":["Fast Access payout ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requested"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:payout"]}," action link, to retrieve the outcome of your payout request. When an update to the outcome is available the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:update"]}," action link will appear in this response.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/payouts/{resource}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example responses:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"requested","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-requested-update.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"requested\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"payouts:update\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"pending","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-pending-update.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"pending\",\n    \"receivedAt\": \"2023-09-06T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"payouts:update\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"approved","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/fast-access-responses/fast-access-approved.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"approved\",\n    \"receivedAt\": \"2025-08-01T12:29:39.625884Z\",\n    \"scheme\": {\n        \"name\": \"visa\",\n        \"reference\": \"972128663763829\"\n    },\n    \"_links\": {\n        \"payouts:payout\": {\n            \"href\": \"https://try.access.worldpay.com/payouts/{resource}\"\n        },\n        \"curies\": [{\n            \"name\": \"payouts\",\n            \"href\": \"https://try.access.worldpay.com/rels/payouts/{rel}\",\n            \"templated\": true\n        }]\n    }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:update"]}," action link to find out the update to the outcome."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If no update is available, you will get an error. You can get further information in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/worldpay-error-responses"},"children":["error reference"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-a-payout-using-the-original-resource","__idx":13},"children":["Retrieve a payout using the original resource"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," to the resource of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:payout"]}," action link, returned in the response of the initial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["basicDisbursement"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fastAccess"]}," request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/payouts/{resource}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{resource}"]}," in the link above with the location given in your initial response."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only"]}," get the location from the initial response."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-a-payout-without-the-original-resource","__idx":14},"children":["Query a payout without the original resource"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the location of an existing payout is lost, the result can still be recovered using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:query"]}," endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To do this you must have the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entity"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}," of the original request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," to the resource of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payouts:query"]}," action link."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/payouts/query?transactionReference={transactionReference}&entity={entity}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{transactionReference}"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{entity}"]}," in the link above with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entity"]}," of the original payout."]}]},"headings":[{"value":"Make a card payout","id":"make-a-card-payout","depth":1},{"value":"Standard payout","id":"standard-payout","depth":2},{"value":"Payout request","id":"payout-request","depth":3},{"value":"Payout schema","id":"payout-schema","depth":3},{"value":"Payout response","id":"payout-response","depth":3},{"value":"Fast Access payouts","id":"fast-access-payouts","depth":2},{"value":"Fast Access request","id":"fast-access-request","depth":3},{"value":"Routing your Fast Access request","id":"routing-your-fast-access-request","depth":4},{"value":"Fast Access schema","id":"fast-access-schema","depth":3},{"value":"Fast Access response","id":"fast-access-response","depth":3},{"value":"Possible outcomes","id":"possible-outcomes","depth":4},{"value":"Outcome examples","id":"outcome-examples","depth":4},{"value":"Fast Access payout outcome of requested , pending or approved","id":"fast-access-payout-outcome-of-requested--pending-or-approved","depth":4},{"value":"Retrieve a payout using the original resource","id":"retrieve-a-payout-using-the-original-resource","depth":2},{"value":"Query a payout without the original resource","id":"query-a-payout-without-the-original-resource","depth":2}],"frontmatter":{"seo":{"title":"Make a card payout"}},"lastModified":"2026-07-09T11:23:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/card-payouts/payouts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}