{"templateId":"markdown","versions":[{"version":"v2","label":"v2","link":"/products/account-payouts/v2/testing","default":false,"active":false,"folderId":"7d817e0b"},{"version":"20250101","label":"2025-01-01 (Latest)","link":"/products/account-payouts/testing","default":true,"active":true,"folderId":"7d817e0b"}],"sharedDataIds":{"sidebar":"sidebar-products/account-payouts/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/account-payouts/openapi","oas-products/account-payouts/@20250101/openapi.yaml":"oas-products/account-payouts/@20250101/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab","openapi-code-sample","code-snippet"]},"custom_product":"Account Payouts","type":"markdown"},"seo":{"title":"Testing | Account Payouts","description":"Test your Account Payouts integration in the Try environment. Send requests and see simulated responses from our banking partners.","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":"Heading","attributes":{"level":1,"id":"testing","__idx":0},"children":["Testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Simulate various scenarios using magic values, to ensure your integration is seamless and reliable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"you-can-test","__idx":1},"children":["You can test:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"sepafaster-paymentsus-ach","__idx":2},"children":["SEPA/Faster Payments/US ACH"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["successful end-to-end payout flow including banking partner validation and notification (status COMPLETED)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"-invalidBankDetails\" end-to-end payout flow including banking partner validation and notification (status REVERSED)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"all-other-payouts","__idx":3},"children":["All other payouts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["correctly formatted and successfully routed payouts (status EXECUTED)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["payouts with incorrectly formatted bank details based on country specific requirements (status REVERSED)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-check-connectivity-to-required-apis","__idx":4},"children":["Step 1: Check connectivity to required APIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure you have connectivity to all necessary APIs:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi"},"children":["Account Payouts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Account APIs (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/balance/openapi"},"children":["Balances API"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/statements/openapi"},"children":["Statements API"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/transfers/openapi"},"children":["Account Transfers API"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/parties/openapi"},"children":["Parties API"]}," (if you store beneficiary details)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"how-to-check-connectivity","__idx":5},"children":["How to check connectivity:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your credential set is valid for all Access APIs, therefore you can do a simple test on one of our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," endpoints to verify whether your credentials are correct:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do a search by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutRequestId"]}," and provide an invalid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutRequestId"]}," (PN00000X):"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/accountPayouts/{payoutRequestId}"]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your credentials ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["are valid"]},", you should receive the below ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 Forbidden"]}," message confirming that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutRequestId"]}," you are querying doesn't belong to your payout:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"errorName\": \"forbidden\",\n  \"message\": \"Forbidden. Unauthorized request\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your credentials ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["are invalid"]}," or you have connectivity issues you should receive the below ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}," message:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"errorName\": \"accessDenied\",\n    \"message\": \"Access to the requested resource has been denied\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-confirm-account-balance","__idx":6},"children":["Step 2: Confirm account balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must have sufficient funds in your account to make a payout."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check balance: Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/balance/openapi"},"children":["Accounts API"]}," to verify available funds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transfer funds: If needed, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/transfers/openapi"},"children":["Account Transfers API"]}," to move funds between your accounts."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Test balance"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the balance is insufficient, use the Transfers API or contact your Worldpay Implementation Manager ."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-end-to-end-testing","__idx":7},"children":["Step 3: End-to-end testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full end-to-end testing, which includes full mimicking of our validations as well our banking partner validations, is only available for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SEPA"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Faster Payments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["US ACH"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When testing these routes you can receive the following statuses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["EXECUTED - sent immediately after the payout was processed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["COMPLETED -  the final status of a payout with a success notification"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["REVERSED - the final status of a payout mimicking a reversal by our banking partners"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For all other payouts the final status will either be:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["EXECUTED or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["REVERSED - a simulated reversal by us, this was not validated by the banking partner"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-prepare-payout-details","__idx":8},"children":["Step 4: Prepare payout details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two ways to send a payout:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["use a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/parties/payout-instruments"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentReference"]}]}," for the payout request - ",{"$$mdtype":"Tag","name":"font","attributes":{"color":"#FF1F3E"},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Mandatory for Marketplaces customers"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["submit full beneficiary bank details directly in the payout request"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-execute-and-monitor-the-payout-process","__idx":9},"children":["Step 5: Execute and monitor the payout process"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit your payout request to either our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/single-payout"},"children":["single"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/batch-payout"},"children":["batch"]}," payout endpoint."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"successful-payout","__idx":10},"children":["Successful payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There is no magic value for a successful payout. To achieve a successful end-to-end test, ensure you include at least one valid payout to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/single-payout"},"children":["single"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/batch-payout"},"children":["batch"]}," payout try endpoint."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-payload","__idx":11},"children":["Example payload"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Account Payout customers","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-products/account-payouts/@20250101/openapi.yaml","operationId":"PostPayout","exampleKey":"SEPA","parameters":{},"environments":{}},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Marketplaces","disable":false},"children":[{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-products/account-payouts/@20250101/openapi.yaml","operationId":"PostPayout","exampleKey":"Marketplace account payout request including payout instrument","parameters":{},"environments":{}},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"invalid-bank-details","__idx":12},"children":["Invalid bank details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/batch-payout"},"children":["batch endpoint"]}," to simulate a payout failure due to invalid bank details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include \"-invalidBankDetails\" as part of the value in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}," field."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To test an invalid payout within a batch, you must include one valid payment to stop internal batch blocking."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor the status: Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/account-payouts/openapi/get-payouts"},"children":["item search endpoint"]}," to query the status of your payout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receive notifications: Await notifications confirming the payout status after validation by us and our banking partners."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review bank messages: In case of rejection, check for specific bank messages:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GBP and EUR Payments: \"Other NARR: Narrative:\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["USD Payments: \"Other NARR:\""]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reconciliation: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/statements/openapi"},"children":["Query your statement"]}," to verify the transaction and test your reconciliation process."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Additional information"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Simulated payout status timing: It can take up to 10 minutes to receive a final status of PAID after submitting a payout. The REJECTED status will take effect at 4:00pm UTC."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-payload-1","__idx":13},"children":["Example payload"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Account Payout customers","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/testing/invalid-batch-account-payout-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"payouts\": [\n    {\n      \"instruction\": {\n        \"value\": {\n          \"sourceCurrency\": \"EUR\",\n          \"sourceAmount\": 0,\n          \"targetCurrency\": \"EUR\",\n          \"targetAmount\": 199.99\n        },\n        \"narrative\": {\n          \"line1\": \"Testing invalid bank details\"\n        },\n        \"countryCode\": \"GB\",\n        \"fastPayment\": false,\n        \"beneficiaryBankDetails\": {\n          \"iban\": \"GB41CITI18500818404062\",\n          \"bankName\": \"Citibank London\"\n        },\n        \"parties\": [\n          {\n            \"partyType\": \"beneficiary\",\n            \"personalDetails\": {\n              \"type\": \"Company\",\n              \"companyName\": \"Worldpay AP Ltd\"\n            },\n            \"address\": {\n              \"address1\": \"25 Walbrook\",\n              \"city\": \"London\",\n              \"postalCode\": \"EC4N 8AF\",\n              \"countryCode\": \"GB\"\n            }\n          }\n        ]\n      },\n      \"transactionReference\": \"ABC123456\"\n    },\n    {\n      \"instruction\": {\n        \"value\": {\n          \"sourceCurrency\": \"EUR\",\n          \"sourceAmount\": 0,\n          \"targetCurrency\": \"EUR\",\n          \"targetAmount\": 199.99\n        },\n        \"narrative\": {\n          \"line1\": \"Testing invalid bank details\"\n        },\n        \"countryCode\": \"GB\",\n        \"fastPayment\": false,\n        \"beneficiaryBankDetails\": {\n          \"iban\": \"GB41CITI18500818401243\",\n          \"bankName\": \"Citibank London\"\n        },\n        \"parties\": [\n          {\n            \"partyType\": \"beneficiary\",\n            \"personalDetails\": {\n              \"type\": \"Company\",\n              \"companyName\": \"Worldpay Ltd\"\n            },\n            \"address\": {\n              \"address1\": \"The Science Park\",\n              \"city\": \"Cambridge\",\n              \"postalCode\": \"CB4 0WE\",\n              \"countryCode\": \"GB\"\n            }\n          }\n        ]\n      },\n      \"transactionReference\": \"ABC123456-invalidBankDetails\"\n    }\n  ]\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Marketplaces","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/testing/invalid-batch-marketplace-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"payouts\": [\n    {\n      \"instruction\": {\n        \"value\": {\n          \"sourceCurrency\": \"GBP\",\n          \"sourceAmount\": 199.99,\n          \"targetAmount\": 0\n        },\n        \"countryCode\": \"US\",\n        \"fastPayment\": false,\n        \"beneficiaryBankDetails\": {\n          \"payoutInstrumentReference\": \"BeneficiaryBankGBP\"\n        }\n      },\n      \"transactionReference\": \"ABC123456\"\n    },\n    {\n      \"instruction\": {\n        \"value\": {\n          \"sourceCurrency\": \"GBP\",\n          \"sourceAmount\": 199.99,\n          \"targetAmount\": 0\n        },\n        \"countryCode\": \"US\",\n        \"fastPayment\": false,\n        \"beneficiaryBankDetails\": {\n          \"payoutInstrumentReference\": \"BeneficiaryBankGBP_2\"\n        }\n      },\n      \"transactionReference\": \"ABC123456-invalidBankDetails\"\n    }\n  ]\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practice-test-cases","__idx":14},"children":["Best practice test cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our schema validation is designed to maximize straight-through processing and respond to you synchronously as soon as the payout data in your request is insufficient. We have set several conditions that we recommend you to test, to ensure that you collect the right data and the payout is successfully sent."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"object-beneficiarybankdetails-mandatory-unless-you-are-paying-to-a-paypalcrypto-wallet","__idx":15},"children":["Object: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiaryBankDetails"]}," (Mandatory, unless you are paying to a PayPal/crypto wallet)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties","__idx":16},"children":["Conditional properties"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iban"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]}," if you are sending a payout in BBAN format and have provided an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountNumber"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountNumber"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]}," if you are sending a payout in IBAN format and have provided an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iban"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentReference"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentId"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}," if you have an on-boarded party with us and you're paying out to them as part of the Marketplaces solution (Marketplaces must not input any other bank details in the payload)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentReference"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentId"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]}," if you have stored beneficiary and bank details and want to use them to submit a payout request (in this scenario you must not input any other bank details in the payload)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceAmount"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetAmount"]}," - Do not include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceAmount"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetAmount"]}," in the same request, only send one or the other. The request is rejected if both are supplied."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"object-parties-beneficiary---mandatory-unless-you-are-using-payoutinstrumentreference-or-payoutinstrumentid-","__idx":17},"children":["Object: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parties"]}," (beneficiary) - (Mandatory, unless you are using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentReference"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentId"]},")"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-1","__idx":18},"children":["Conditional properties"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partyReference"]}," — Not allowed for the beneficiary object. If you want to use stored details, you must provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentReference"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutInstrumentId"]}," under the beneficiaryBankDetails object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails"]}," (beneficiary)",{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-2","__idx":19},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyName"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["institution"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["government"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}," types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["person"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["soleTrader"]}," types."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails.phones"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-3","__idx":20},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," - If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," is given, you must also provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]}," - If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]}," is given, you must also provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails.identityDocuments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-4","__idx":21},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuingCountry"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validFrom"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validTo"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuingInstitution"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"object-parties-payer---optional-unless-you-are-on-boarded-with-us-as-a-payment-service-provider-and-requesting-this-payout-on-behalf-of-a-3rd-party","__idx":22},"children":["Object: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parties"]}," (payer) - (Optional, unless you are on-boarded with us as a Payment Service Provider and requesting this payout on behalf of a 3rd party)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We don't validate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyName"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}," upfront for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer"]}," (like we do for a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary"]},"). However, your request will be rejected in downstream processing if those are not provided. More details on the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketplaces/coverage/bank/additionalinfo#payment-service-provider-psp-and-money-service-business-msb-merchants"},"children":["payer validation for PSPs"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-5","__idx":23},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partyReference"]}," - Use this if you have your payer details stored with us and want to use it with that payout (in this scenario you must not use any other input details for this party)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails"]}," (payer)",{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-6","__idx":24},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["companyName"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["institution"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["government"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}," types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["person"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["soleTrader"]}," types."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails.phones"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-7","__idx":25},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," - If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," is given, you must also provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]}," - If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prefix"]}," is given, you must also provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personalDetails.identityDocuments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":5,"id":"conditional-properties-8","__idx":26},"children":["Conditional properties:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuingCountry"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mandatory"]},". You must provide this, if any of other mandatory details of this object are given."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validFrom"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["validTo"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuingInstitution"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]},". Only allowed if you have provided all mandatory details of this object."]}]}]}]}]},"headings":[{"value":"Testing","id":"testing","depth":1},{"value":"You can test:","id":"you-can-test","depth":3},{"value":"SEPA/Faster Payments/US ACH","id":"sepafaster-paymentsus-ach","depth":4},{"value":"All other payouts:","id":"all-other-payouts","depth":4},{"value":"Step 1: Check connectivity to required APIs","id":"step-1-check-connectivity-to-required-apis","depth":3},{"value":"How to check connectivity:","id":"how-to-check-connectivity","depth":4},{"value":"Step 2: Confirm account balance","id":"step-2-confirm-account-balance","depth":3},{"value":"Step 3: End-to-end testing","id":"step-3-end-to-end-testing","depth":3},{"value":"Step 4: Prepare payout details","id":"step-4-prepare-payout-details","depth":3},{"value":"Step 5: Execute and monitor the payout process","id":"step-5-execute-and-monitor-the-payout-process","depth":3},{"value":"Successful payout","id":"successful-payout","depth":4},{"value":"Example payload","id":"example-payload","depth":4},{"value":"Invalid bank details","id":"invalid-bank-details","depth":4},{"value":"Example payload","id":"example-payload-1","depth":4},{"value":"Best practice test cases","id":"best-practice-test-cases","depth":2},{"value":"Object: beneficiaryBankDetails (Mandatory, unless you are paying to a PayPal/crypto wallet)","id":"object-beneficiarybankdetails-mandatory-unless-you-are-paying-to-a-paypalcrypto-wallet","depth":4},{"value":"Conditional properties","id":"conditional-properties","depth":5},{"value":"Object: parties (beneficiary) - (Mandatory, unless you are using payoutInstrumentReference or payoutInstrumentId )","id":"object-parties-beneficiary---mandatory-unless-you-are-using-payoutinstrumentreference-or-payoutinstrumentid-","depth":4},{"value":"Conditional properties","id":"conditional-properties-1","depth":5},{"value":"Conditional properties:","id":"conditional-properties-2","depth":5},{"value":"Conditional properties:","id":"conditional-properties-3","depth":5},{"value":"Conditional properties:","id":"conditional-properties-4","depth":5},{"value":"Object: parties (payer) - (Optional, unless you are on-boarded with us as a Payment Service Provider and requesting this payout on behalf of a 3rd party)","id":"object-parties-payer---optional-unless-you-are-on-boarded-with-us-as-a-payment-service-provider-and-requesting-this-payout-on-behalf-of-a-3rd-party","depth":4},{"value":"Conditional properties:","id":"conditional-properties-5","depth":5},{"value":"Conditional properties:","id":"conditional-properties-6","depth":5},{"value":"Conditional properties:","id":"conditional-properties-7","depth":5},{"value":"Conditional properties:","id":"conditional-properties-8","depth":5}],"frontmatter":{"seo":{"title":"Testing | Account Payouts","description":"Test your Account Payouts integration in the Try environment. Send requests and see simulated responses from our banking partners."},"markdown":{"toc":{"hide":false}},"breadcrumbs":{"hide":true}},"lastModified":"2026-05-19T08:41:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/account-payouts/testing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}