{
"code": "forbidden",
"message": "Forbidden",
"errors": [
{
"field": "source.amount",
"message": "Source amount must be a numeric string. Example \"100\" or \"10.25\"."
}
]
}
{
"code": "forbidden",
"message": "Forbidden",
"errors": [
{
"field": "source.amount",
"message": "Source amount must be a numeric string. Example \"100\" or \"10.25\"."
}
]
}
{
"code": "forbidden",
"message": "Forbidden",
"errors": [
{
"field": "source.amount",
"message": "Source amount must be a numeric string. Example \"100\" or \"10.25\"."
}
]
}
{
"code": "forbidden",
"message": "Forbidden",
"errors": [
{
"field": "source.amount",
"message": "Source amount must be a numeric string. Example \"100\" or \"10.25\"."
}
]
}
Some Platform API capabilities must be enabled on your account by MoonPay
before you can call them. If this endpoint returns an unexpected 404, see
Capability
enablement.
This endpoint works only in test
mode. Live-mode transactions
return 403. In production, bank transfers settle when the customer’s deposit
arrives.
Transaction with lifecycle stages showing step-by-step progress.
Show child attributes
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"MoonPay Developer Docs","description":"Integrate MoonPay's on-ramp, off-ramp, and swap products: widgets, SDKs, and APIs that let your users buy, sell, and swap crypto.","colors":{"primary":"#903DD9","light":"#A473EE","dark":"#903DD9"},"logo":{"light":"https://mintcdn.com/moonpay/BslMWtNt3goK8NG4/images/platform/logo/light.svg?fit=max\u0026auto=format\u0026n=BslMWtNt3goK8NG4\u0026q=85\u0026s=c5835bb4dbc3485f635eb0a055a9aeda","dark":"https://mintcdn.com/moonpay/BslMWtNt3goK8NG4/images/platform/logo/dark.svg?fit=max\u0026auto=format\u0026n=BslMWtNt3goK8NG4\u0026q=85\u0026s=c9414586d4260a86b2ecc81cf3be164b"},"favicon":"https://mintcdn.com/moonpay/ngx7B4NPEl3EzY5E/favicon.svg?fit=max\u0026auto=format\u0026n=ngx7B4NPEl3EzY5E\u0026q=85\u0026s=9873c77c8542701f6ac2203b0e49caf4","api":{"openapi":["https://api.moonpay.com/platform/openapi.json","api-reference/widget/ramps-and-swaps.openapi.json","api-reference/widget/virtual-accounts.openapi.json","api-reference/widget/server-to-server.openapi.json"],"playground":{"display":"simple"}},"appearance":{"default":"dark"},"seo":{"metatags":{"canonical":"https://dev.moonpay.com"}},"integrations":{"ga4":{"measurementId":"G-PPC3SM5WJD"}},"contextual":{"options":["copy","view","mcp","claude","cursor","chatgpt"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Help Center","icon":"life-ring","href":"https://support.moonpay.com/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"moonpay","hasAudioNarration":false,"actualSubdomain":"moonpay","customDomains":["dev.moonpay.com"],"gitSource":{"type":"github","owner":"moonpay","repo":"developer-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae47c7ec0a5d590d24c7725","collectionId":"56c9b4ae-1600-474d-904b-9a34b02ea4fb","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae47c7ec0a5d590d24c7725"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae47c7ec0a5d590d24c7725","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Platform","count":96},{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"SDK Reference","count":56},{"language":"default","tag":"Widget API","count":43},{"language":"default","tag":"Widget","count":40},{"language":"default","tag":"React Native","count":29},{"language":"default","tag":"Platform API","count":28},{"language":"default","tag":"Web","count":20},{"language":"default","tag":"On-Ramp","count":17},{"language":"default","tag":"Customers","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/platform/endpoints/transactions/simulate-bank-transfer","slug":"/api-reference/platform/endpoints/transactions/simulate-bank-transfer","pageMetadata":{"title":"Simulate bank-transfer settlement","description":"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.","openapi":"POST /platform/v1/transactions/{id}/simulate-bank-transfer","href":"/api-reference/platform/endpoints/transactions/simulate-bank-transfer"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Some Platform API capabilities must be enabled on your account by MoonPay\nbefore you can call them. If this endpoint returns an unexpected `,_jsx(_components.code,{children:`404`}),`, see\n`,_jsx(_components.a,{href:`/api-reference/platform/documentation/using-the-api#capability-enablement`,children:`Capability\nenablement`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`This endpoint works only in `,_jsx(_components.a,{href:`/platform/overview/test-mode#bank-transfers`,children:`test\nmode`}),`. Live-mode transactions\nreturn `,_jsx(_components.code,{children:`403`}),`. In production, bank transfers settle when the customer’s deposit\narrives.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Simulate bank-transfer settlement","description":"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.","openapi":"POST /platform/v1/transactions/{id}/simulate-bank-transfer","href":"/api-reference/platform/endpoints/transactions/simulate-bank-transfer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"TransactionController.simulateBankTransfer","summary":"Simulate bank-transfer settlement (sandbox only)","description":"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.","parameters":["b05ce0a4-0434-409f-b04c-3262036d185a"],"responses":{"200":"f852b785-8c07-44d9-802a-ba36e87f9687","400":"07fed5d0-04a6-4872-b77a-adfe4cb7071b","401":"45fee693-e75a-4b0b-947c-014b0a2957e2","403":"ce3756a5-8fab-4b70-add6-677721d5287f","404":"f89fa6a9-58ec-4674-8b00-7cb6414d5286","409":"a66633bf-dd14-4111-a9d3-d56653481af8"},"tags":["Transactions"],"requestBody":"790133f9-c49d-4aee-a363-d237b708771b","security":["5c908d3c-1f8b-4b61-af19-1842d69aa852"],"method":"post","type":"path","servers":["11603ead-91a5-4072-a4a5-0b4dd20dc165","a8ec0de7-950b-4e7b-bced-946cae6cb48c"],"path":"/platform/v1/transactions/{id}/simulate-bank-transfer","baseUrlOptions":["https://api.moonpay.com","https://api.moonpay.dev"],"title":"Simulate bank-transfer settlement (sandbox only)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b05ce0a4-0434-409f-b04c-3262036d185a":{"name":"id","in":"path","required":true,"description":"The MoonPay ID of the transaction.","schema":{"type":"string","isRequired":true,"description":"The MoonPay ID of the transaction.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["outcome"],"properties":{"outcome":{"type":"string","enum":["settled","timeout"],"description":"Which settlement outcome to simulate.","isRequired":true,"uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"senderBankAccount":{"type":"object","required":["accountHolderName"],"properties":{"accountHolderName":{"type":"string","description":"The name on the sender's bank account.","isRequired":true,"uniqueKey":"senderBankAccount.accountHolderName","typeLabel":"string"},"iban":{"type":"string","description":"The sender's IBAN. Used for SEPA (EUR) transfers.","uniqueKey":"senderBankAccount.iban","typeLabel":"string"},"accountNumber":{"type":"string","description":"The sender's account number. Used for Faster Payments (GBP) transfers.","uniqueKey":"senderBankAccount.accountNumber","typeLabel":"string"},"sortCode":{"type":"string","description":"The sender's sort code. Used for Faster Payments (GBP) transfers.","uniqueKey":"senderBankAccount.sortCode","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"Optional sender bank account used to create the customer's bank account when settling. Defaults are synthesized per currency when omitted.","uniqueKey":"senderBankAccount","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Request body for simulating bank-transfer settlement.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f852b785-8c07-44d9-802a-ba36e87f9687":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"Transaction with lifecycle stages showing step-by-step progress.","required":["id","transactionHash","createdAt","updatedAt","status","source","destination","fees","wallet","customer"],"properties":{"id":{"type":"string","description":"The MoonPay ID of the transaction.","examples":["fd43b900-593b-4125-9616-7d721ecbe875"],"isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"transactionHash":{"oneOf":[{"type":"string","description":"The on-chain transaction hash for the cryptocurrency transfer. Populated only when `status` is `completed` and a hash is available.","example":"0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","isRequired":true,"uniqueKey":"data.transactionHash.oneOf.0","typeLabel":"string"},{"type":"null","description":"The on-chain transaction hash for the cryptocurrency transfer. Populated only when `status` is `completed` and a hash is available.","example":"0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","isRequired":true,"uniqueKey":"data.transactionHash.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.transactionHash","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","description":"An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the transaction was created.","examples":["2026-01-29T14:30:50.000Z"],"isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the transaction was last updated.","examples":["2026-01-29T15:30:50.000Z"],"isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","enum":["completed","failed","pending"],"description":"The status of a transaction.\n\n- `completed`: The transaction is finalized and assets were delivered.\n- `failed`: The transaction failed. No payment was executed and funds were not transferred.\n- `pending`: The transaction was created and payment is accepted. The transfer is in progress.","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"source":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"A stringified amount, which can include decimals.","examples":["100.02","10.22","1.00","10","1"],"isRequired":true,"uniqueKey":"data.source.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.source.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The currency or token being spent","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.source.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Total source amount and asset (fiat currency) the customer pays, including all fees. Matches the quote's `source.amount`. For bank-transfer payment methods this is the exact amount the customer must transfer.","examples":[{"amount":"100.02","asset":{"code":"USD"}}],"isRequired":true,"uniqueKey":"data.source","typeLabel":"object"},"destination":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"A stringified amount, which can include decimals.","examples":["100.02","10.22","1.00","10","1"],"isRequired":true,"uniqueKey":"data.destination.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.destination.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"isRequired":true,"uniqueKey":"data.destination.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Destination amount and asset (cryptocurrency) the customer receives. For bank-transfer (floating) payment methods this is an estimate while the transaction is pending, consistent with the quote's `destination.amount`; the exact amount is set at settlement.","examples":[{"amount":"100.02","asset":{"code":"USDC"}}],"isRequired":true,"uniqueKey":"data.destination","typeLabel":"object"},"fees":{"type":"object","properties":{"network":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"The amount of fees in fiat.","examples":["1","1.00","10.22","100.02"],"isRequired":true,"uniqueKey":"data.fees.network.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.fees.network.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The fiat currency used to pay the fees.","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.fees.network.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Network fees (in fiat) for the transaction.","uniqueKey":"data.fees.network","typeLabel":"object"},"moonpay":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"The amount of fees in fiat.","examples":["1","1.00","10.22","100.02"],"isRequired":true,"uniqueKey":"data.fees.moonpay.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.fees.moonpay.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The fiat currency used to pay the fees.","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.fees.moonpay.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"MoonPay fees (in fiat) for the transaction.","uniqueKey":"data.fees.moonpay","typeLabel":"object"},"ecosystem":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"The amount of fees in fiat.","examples":["1","1.00","10.22","100.02"],"isRequired":true,"uniqueKey":"data.fees.ecosystem.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.fees.ecosystem.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The fiat currency used to pay the fees.","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.fees.ecosystem.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Ecosystem fees (in fiat) for the transaction, if applicable.","uniqueKey":"data.fees.ecosystem","typeLabel":"object"},"defi":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"The amount of fees in fiat.","examples":["1","1.00","10.22","100.02"],"isRequired":true,"uniqueKey":"data.fees.defi.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.fees.defi.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The fiat currency used to pay the fees.","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.fees.defi.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"DeFi swap fee (in fiat) for the transaction, converted to the quote's base currency like the other fees. Present only for DeFi swaps that carry an itemized swap fee; when the fee is taken on-chain it is reflected in `destination.amount` instead.","uniqueKey":"data.fees.defi","typeLabel":"object"},"partner":{"type":"object","required":["amount","asset"],"properties":{"amount":{"type":"string","description":"The amount of fees in fiat.","examples":["1","1.00","10.22","100.02"],"isRequired":true,"uniqueKey":"data.fees.partner.amount","typeLabel":"string"},"asset":{"type":"object","required":["code"],"properties":{"code":{"type":"string","description":"A fiat or crypto currency code.\n\n**Fiat**\nFiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.\n\n**Crypto**\nFor crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).\n\nExamples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`","isRequired":true,"uniqueKey":"data.fees.partner.asset.code","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"The fiat currency used to pay the fees.","examples":[{"code":"USD"}],"isRequired":true,"uniqueKey":"data.fees.partner.asset","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"description":"Partner fees (in fiat) for the transaction, if applicable. Deprecated: use `fees.ecosystem` instead. This field will be removed in a future release.","deprecated":true,"uniqueKey":"data.fees.partner","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"examples":[{"network":{"amount":"2.39","asset":{"code":"USD"}},"moonpay":{"amount":"4.99","asset":{"code":"USD"}},"ecosystem":{"amount":"1.00","asset":{"code":"USD"}}}],"description":"Details of fees for the transaction.","isRequired":true,"uniqueKey":"data.fees","typeLabel":"object"},"wallet":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"The wallet address used for the transaction.","examples":["0x1234567890123456789012345678901234567890"],"isRequired":true,"uniqueKey":"data.wallet.address","typeLabel":"string"},"tag":{"type":"string","description":"An optional memo or destination tag (used by some blockchains such as XRP or XLM).","uniqueKey":"data.wallet.tag","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"examples":[{"address":"0x1234567890123456789012345678901234567890"}],"description":"The wallet used for the transaction.","isRequired":true,"uniqueKey":"data.wallet","typeLabel":"object"},"customer":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"The MoonPay ID of the customer associated with the transaction.","examples":["e0dee0ac-4e62-4866-b044-f66c0e4046e9"],"isRequired":true,"uniqueKey":"data.customer.id","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"isRequired":true,"uniqueKey":"data.customer","typeLabel":"object"},"paymentMethod":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["apple_pay","card","ach","fps","fps_open_banking","google_pay","sepa","sepa_open_banking","pix","paypal","venmo","revolut_pay","moonpay_balance","interac"],"isRequired":true,"uniqueKey":"data.paymentMethod.type","typeLabel":"enum\u003cstring>"}},"unevaluatedProperties":{"not":{}},"uniqueKey":"data.paymentMethod","typeLabel":"object"},"bankTransferDepositInfo":{"type":"object","required":["reference","recipientName","recipientAddress"],"properties":{"reference":{"type":"string","description":"The payment reference the customer must include with the bank transfer so MoonPay can match the payment to the transaction. The customer must always include it - transfers sent without the reference are rejected.","isRequired":true,"uniqueKey":"data.bankTransferDepositInfo.reference","typeLabel":"string"},"recipientName":{"type":"string","description":"The name of the recipient account holder the customer should send the transfer to.","isRequired":true,"uniqueKey":"data.bankTransferDepositInfo.recipientName","typeLabel":"string"},"recipientAddress":{"type":"string","description":"The address of the recipient account holder the customer should send the transfer to.","isRequired":true,"uniqueKey":"data.bankTransferDepositInfo.recipientAddress","typeLabel":"string"},"accountNumber":{"type":"string","description":"The account number of the recipient account. Provided for domestic transfers such as Faster Payments (FPS); UK account numbers are 8 digits.","uniqueKey":"data.bankTransferDepositInfo.accountNumber","typeLabel":"string"},"bankAddress":{"type":"string","description":"The address of the recipient's bank.","uniqueKey":"data.bankTransferDepositInfo.bankAddress","typeLabel":"string"},"bankName":{"type":"string","description":"The name of the recipient's bank.","uniqueKey":"data.bankTransferDepositInfo.bankName","typeLabel":"string"},"bic":{"type":"string","description":"The BIC (SWIFT code) of the recipient account, 8 or 11 characters. Provided for SEPA transfers.","uniqueKey":"data.bankTransferDepositInfo.bic","typeLabel":"string"},"iban":{"type":"string","description":"The IBAN of the recipient account (up to 34 alphanumeric characters). Provided for SEPA transfers.","uniqueKey":"data.bankTransferDepositInfo.iban","typeLabel":"string"},"sortCode":{"type":"string","description":"The sort code of the recipient bank, 6 digits. Provided for domestic transfers such as Faster Payments (FPS).","uniqueKey":"data.bankTransferDepositInfo.sortCode","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"Bank account details and payment reference for completing a bank transfer. Present only for bank-transfer payment methods such as SEPA and Faster Payments (FPS).","examples":[{"reference":"MP-8F3K2A","recipientName":"MoonPay Ltd","recipientAddress":"1 Market Street, London, EC1A 1AA, United Kingdom","iban":"GB29NWBK60161331926819","bic":"NWBKGB2L","bankName":"MoonPay Bank","bankAddress":"1 Market Street, London, EC1A 1AA, United Kingdom"}],"uniqueKey":"data.bankTransferDepositInfo","typeLabel":"object"},"stages":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["ordering","waiting_payment","waiting_authentication","verification","processing","delivery","crypto_hold"],"description":"The stages in a transaction lifecycle.","uniqueKey":"data.stages.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The human-readable name of the stage.","uniqueKey":"data.stages.items.[INDEX].name","typeLabel":"string"},"status":{"type":"string","enum":["not_started","in_progress","success","failed"],"description":"The status of a transaction stage.","uniqueKey":"data.stages.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"failureReason":{"oneOf":[{"type":"string","description":"A developer-friendly message if the status is `failed`","uniqueKey":"data.stages.items.[INDEX].failureReason.oneOf.0","typeLabel":"string"},{"type":"null","description":"A developer-friendly message if the status is `failed`","uniqueKey":"data.stages.items.[INDEX].failureReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.stages.items.[INDEX].failureReason","typeLabel":"string | null"}},"unevaluatedProperties":{"not":{}},"description":"A stage in the transaction lifecycle","examples":[{"kind":"delivery","status":"success"}],"uniqueKey":"data.stages.items.[INDEX]","typeLabel":"object"},"description":"Details of the stages in the transaction lifecycle.","uniqueKey":"data.stages","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"unevaluatedProperties":{"not":{}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"fd43b900-593b-4125-9616-7d721ecbe875","transactionHash":"0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","createdAt":"2026-01-29T14:30:50.000Z","updatedAt":"2026-01-29T15:30:50.000Z","status":"completed","source":{"amount":"100.02","asset":{"code":"USD"}},"destination":{"amount":"100.02","asset":{"code":"USDC"}},"fees":{"network":{"amount":"2.39","asset":{"code":"USD"}},"moonpay":{"amount":"4.99","asset":{"code":"USD"}},"ecosystem":{"amount":"1.00","asset":{"code":"USD"}}},"wallet":{"address":"0x1234567890123456789012345678901234567890"},"customer":{"id":"e0dee0ac-4e62-4866-b044-f66c0e4046e9"},"paymentMethod":{"type":"apple_pay"},"bankTransferDepositInfo":{"reference":"MP-8F3K2A","recipientName":"MoonPay Ltd","recipientAddress":"1 Market Street, London, EC1A 1AA, United Kingdom","iban":"GB29NWBK60161331926819","bic":"NWBKGB2L","bankName":"MoonPay Bank","bankAddress":"1 Market Street, London, EC1A 1AA, United Kingdom"},"stages":[{"kind":"delivery","status":"success"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"07fed5d0-04a6-4872-b77a-adfe4cb7071b":{"description":"The server could not understand the request due to invalid syntax.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["unknown_error","unauthorized","forbidden","not_found","invalid_request","not_implemented","too_many_requests","not_allowed","conflict","unprocessable_entity","sse_timeout","sse_error","service_unavailable","requirements_incomplete","requirement_not_pending","verification_rejected","country_mismatch","upload_expired","unsupported_country","verification_pending","kyc_not_approved","no_outstanding_requirements","terms_accepted_at_out_of_range","unsupported_combination","asset_not_available_in_region","address_confirmation_required"],"description":"Code identifying the error type.","examples":["forbidden","unauthorized","invalid_request"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message.","examples":["Forbidden","Not authorized","One or more request parameters are invalid."],"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message for this field.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Field that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"details":{"type":"object","unevaluatedProperties":{},"description":"Extra data that describes the error in more detail, useful when debugging or logging. Keys vary by error and are not part of the API contract. For example, an amount-limit error includes the limit value as \"maxBuyAmount\" or \"minBuyAmount\".","uniqueKey":"errors.items.[INDEX].details","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Optional list of field-level error details.","examples":[[{"field":"source.amount","message":"Source amount must be a numeric string. Example \"100\" or \"10.25\"."}]],"uniqueKey":"errors","typeLabel":"object[]"}},"unevaluatedProperties":{"not":{}},"description":"Response body returned when a request fails.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"Forbidden","errors":[{"field":"source.amount","message":"Source amount must be a numeric string. Example \"100\" or \"10.25\"."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"45fee693-e75a-4b0b-947c-014b0a2957e2":{"description":"Access is unauthorized.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["unauthorized"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","enum":["Not authorized"],"isRequired":true,"uniqueKey":"message","typeLabel":"enum\u003cstring>"}},"unevaluatedProperties":{"not":{}},"description":"Missing or invalid credentials.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"unauthorized","message":"Not authorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"ce3756a5-8fab-4b70-add6-677721d5287f":{"description":"Access is forbidden.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["forbidden"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","examples":["Forbidden"],"isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"unevaluatedProperties":{"not":{}},"description":"Insufficient permissions.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"Forbidden"}}},"exampleType":"generated"}},"exampleType":"generated"},"f89fa6a9-58ec-4674-8b00-7cb6414d5286":{"description":"The server cannot find the requested resource.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["unknown_error","unauthorized","forbidden","not_found","invalid_request","not_implemented","too_many_requests","not_allowed","conflict","unprocessable_entity","sse_timeout","sse_error","service_unavailable","requirements_incomplete","requirement_not_pending","verification_rejected","country_mismatch","upload_expired","unsupported_country","verification_pending","kyc_not_approved","no_outstanding_requirements","terms_accepted_at_out_of_range","unsupported_combination","asset_not_available_in_region","address_confirmation_required"],"description":"Code identifying the error type.","examples":["forbidden","unauthorized","invalid_request"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message.","examples":["Forbidden","Not authorized","One or more request parameters are invalid."],"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message for this field.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Field that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"details":{"type":"object","unevaluatedProperties":{},"description":"Extra data that describes the error in more detail, useful when debugging or logging. Keys vary by error and are not part of the API contract. For example, an amount-limit error includes the limit value as \"maxBuyAmount\" or \"minBuyAmount\".","uniqueKey":"errors.items.[INDEX].details","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Optional list of field-level error details.","examples":[[{"field":"source.amount","message":"Source amount must be a numeric string. Example \"100\" or \"10.25\"."}]],"uniqueKey":"errors","typeLabel":"object[]"}},"unevaluatedProperties":{"not":{}},"description":"Response body returned when a request fails.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"forbidden","message":"Forbidden","errors":[{"field":"source.amount","message":"Source amount must be a numeric string. Example \"100\" or \"10.25\"."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a66633bf-dd14-4111-a9d3-d56653481af8":{"description":"The request conflicts with the current state of the server.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["conflict"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","examples":["Conflict"],"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Human-readable error message for this field.","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"field":{"type":"string","description":"Field that caused the error.","uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"details":{"type":"object","unevaluatedProperties":{},"description":"Extra data that describes the error in more detail, useful when debugging or logging. Keys vary by error and are not part of the API contract. For example, an amount-limit error includes the limit value as \"maxBuyAmount\" or \"minBuyAmount\".","uniqueKey":"errors.items.[INDEX].details","typeLabel":"object"}},"unevaluatedProperties":{"not":{}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"unevaluatedProperties":{"not":{}},"description":"The request conflicts with the current customer state.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"conflict","message":"Conflict","errors":[{"message":"\u003cstring>","field":"\u003cstring>","details":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5c908d3c-1f8b-4b61-af19-1842d69aa852":{"AccessTokenAuth":{"type":"http","scheme":"bearer","description":"Bearer authentication header using an access token.\n\nExample: `Authorization: Bearer \u003caccessToken>`","scopes":[],"schemeName":"AccessTokenAuth"}}},"servers":{"11603ead-91a5-4072-a4a5-0b4dd20dc165":{"url":"https://api.moonpay.com","description":"Production Environment","variables":{}},"a8ec0de7-950b-4e7b-bced-946cae6cb48c":{"url":"https://api.moonpay.dev","description":"Sandbox Environment","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header using an access token.\n\nExample: `Authorization: Bearer \u003caccessToken>`","scopes":[],"schemeName":"AccessTokenAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header using an access token.\n\nExample: `Authorization: Bearer \u003caccessToken>`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AccessTokenAuth","name":"Authorization"}],"title":"AccessTokenAuth"}]},"originalFileLocation":"https://api.moonpay.com/platform/openapi.json"},"subdomain":"moonpay","siteName":"MoonPay Developer Docs","title":"Simulate bank-transfer settlement - MoonPay Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-01T12:12:16.651Z","originalFileLocation":"api-reference/platform/endpoints/transactions/simulate-bank-transfer.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MoonPay Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Simulate bank-transfer settlement - MoonPay Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MoonPay Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://moonpay.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Simulate+bank-transfer+settlement\u0026amp;description=Sandbox+only.+Drive+a+waiting-payment+bank-transfer+transaction+to+a+terminal+outcome+without+real+funds.\u0026amp;theme=a47d0be1f7e6328ec525d617\u0026amp;signature=db05ed6e2c24e65826d5fdf72b191b4efe790b30a13918505e51463cb2bd1628\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Simulate bank-transfer settlement - MoonPay Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://moonpay.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Simulate+bank-transfer+settlement\u0026amp;description=Sandbox+only.+Drive+a+waiting-payment+bank-transfer+transaction+to+a+terminal+outcome+without+real+funds.\u0026amp;theme=a47d0be1f7e6328ec525d617\u0026amp;signature=db05ed6e2c24e65826d5fdf72b191b4efe790b30a13918505e51463cb2bd1628\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/moonpay/Ab1BP3eXcK1clOJ3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MoonPay Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#903DD9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/platform/endpoints/transactions/simulate-bank-transfer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dev.moonpay.com/#organization\",\"name\":\"MoonPay Developer Docs\",\"url\":\"https://dev.moonpay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/moonpay/BslMWtNt3goK8NG4/images/platform/logo/light.svg?fit=max\u0026auto=format\u0026n=BslMWtNt3goK8NG4\u0026q=85\u0026s=c5835bb4dbc3485f635eb0a055a9aeda\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dev.moonpay.com#website\",\"name\":\"MoonPay Developer Docs\",\"url\":\"https://dev.moonpay.com\",\"publisher\":{\"@id\":\"https://dev.moonpay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer#webpage\",\"url\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer\",\"name\":\"Simulate bank-transfer settlement\",\"description\":\"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\",\"dateModified\":\"2026-09-01T12:12:16.651Z\",\"isPartOf\":{\"@id\":\"https://dev.moonpay.com#website\"},\"breadcrumb\":{\"@id\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Simulate bank-transfer settlement\",\"item\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer#apireference\",\"headline\":\"Simulate bank-transfer settlement\",\"name\":\"Simulate bank-transfer settlement\",\"description\":\"Sandbox only. Drive a waiting-payment bank-transfer transaction to a terminal outcome without real funds.\",\"url\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer\",\"mainEntityOfPage\":{\"@id\":\"https://dev.moonpay.com/api-reference/platform/endpoints/transactions/simulate-bank-transfer#webpage\"},\"dateModified\":\"2026-09-01T12:12:16.651Z\",\"publisher\":{\"@id\":\"https://dev.moonpay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://dev.moonpay.com#website\"}}]}\u003c/script>","siteName":"MoonPay Developer Docs","nav":{"global":{"anchors":[{"anchor":"Help Center","icon":"life-ring","href":"https://support.moonpay.com/"}]},"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/platform/overview/introduction"}]},{"tab":"Widget","pages":[{"title":"Widget","href":"/widget/overview"}]},{"tab":"API Reference","dropdowns":[{"dropdown":"Platform API","icon":"code","groups":[{"group":"Documentation","pages":[{"title":"Using the Platform API","href":"/api-reference/platform/documentation/using-the-api"}]},{"group":"Sessions","pages":[{"title":"Create a session","openapi":"POST /platform/v1/sessions","href":"/api-reference/platform/endpoints/sessions/create"},{"title":"Revoke a session","openapi":"DELETE /platform/v1/sessions","href":"/api-reference/platform/endpoints/sessions/revoke"}]},{"group":"Customers","pages":[{"title":"Get a customer","openapi":"GET /platform/v1/customers/{id}","href":"/api-reference/platform/endpoints/customers/get"},{"title":"Get customers by external customer ID","openapi":"GET /platform/v1/customers/ext/{externalCustomerId}","href":"/api-reference/platform/endpoints/customers/get-by-external-id"},{"title":"Submit KYC data","openapi":"PATCH /platform/v1/customers/{id}/kyc","href":"/api-reference/platform/endpoints/customers/submit-kyc"},{"title":"Get a file upload URL","openapi":"POST /platform/v1/customers/{id}/files/upload-url","href":"/api-reference/platform/endpoints/customers/get-upload-url"},{"title":"Confirm uploaded files","openapi":"POST /platform/v1/customers/{id}/files","href":"/api-reference/platform/endpoints/customers/submit-files"},{"title":"Export customer data","openapi":"POST /platform/v1/customers/export","href":"/api-reference/platform/endpoints/customers/export"}]},{"group":"Payment Methods","pages":[{"title":"List payment methods","openapi":"GET /platform/v1/payment-methods","href":"/api-reference/platform/endpoints/payment-methods/list"},{"title":"Delete a payment method","openapi":"DELETE /platform/v1/payment-methods/{paymentMethodId}","href":"/api-reference/platform/endpoints/payment-methods/delete"}]},{"group":"Assets","pages":[{"title":"List assets","openapi":"GET /platform/v1/assets","href":"/api-reference/platform/endpoints/assets/list"}]},{"group":"Quotes","pages":[{"title":"Get a quote","openapi":"POST /platform/v1/quotes/buy","href":"/api-reference/platform/endpoints/quotes/get"}]},{"group":"Transactions","pages":[{"title":"List transactions","openapi":"GET /platform/v1/transactions","href":"/api-reference/platform/endpoints/transactions/list"},{"title":"Get a transaction","description":"Get details for a single transaction by ID","openapi":"GET /platform/v1/transactions/{id}","href":"/api-reference/platform/endpoints/transactions/get"},{"title":"Simulate bank-transfer settlement","openapi":"POST /platform/v1/transactions/{id}/simulate-bank-transfer","href":"/api-reference/platform/endpoints/transactions/simulate-bank-transfer"}]},{"group":"Webhooks","pages":[{"title":"Overview","description":"Receive Platform webhook events and verify that MoonPay sent them.","href":"/api-reference/platform/webhooks/overview"},{"title":"Customer identity status updated","openapi":"openapi-webhooks.json webhook customerIdentityStatusUpdated","href":"/api-reference/platform/webhooks/customer-identity-status-updated"}]},{"group":"Objects \u0026 Types","pages":[{"title":"Customer","href":"/api-reference/platform/objects-and-types/customer"},{"title":"Customer export","href":"/api-reference/platform/objects-and-types/customer-export"},{"title":"Transaction","href":"/api-reference/platform/objects-and-types/transaction"},{"title":"Stage","href":"/api-reference/platform/objects-and-types/stage"},{"title":"Stage failure reasons","href":"/api-reference/platform/objects-and-types/stage-failure-reasons"},{"title":"Quote","href":"/api-reference/platform/objects-and-types/quote"},{"title":"Payment Method","href":"/api-reference/platform/objects-and-types/payment-method"},{"title":"Asset","href":"/api-reference/platform/objects-and-types/asset"},{"title":"Fees","href":"/api-reference/platform/objects-and-types/fees"},{"title":"Wallet","href":"/api-reference/platform/objects-and-types/wallet"}]}]},{"dropdown":"Widget API","icon":"window","groups":[{"group":"Overview","pages":[{"title":"Overview","href":"/api-reference/widget/overview"},{"title":"Using the API","href":"/api-reference/widget/using-the-api"},{"title":"Errors","href":"/api-reference/widget/errors"}]},{"group":"Customers","pages":[{"title":"Get customer","openapi":"GET /v1/customers/{customerId}","href":"/api-reference/widget/getcustomer"},{"title":"Get customer by externalId","openapi":"GET /v1/customers/ext/{customerId}","href":"/api-reference/widget/getcustomerbyexternalid"},{"title":"Import customer identity","openapi":"POST /v3/customers/import","href":"/api-reference/widget/importcustomer"}]},{"group":"On-ramp","pages":[{"title":"Get Real-time Buy quote","openapi":"GET /v3/currencies/{currencyCode}/buy_quote","href":"/api-reference/widget/getbuyquote"},{"title":"Get Crypto Currency limits","openapi":"GET /v3/currencies/{currencyCode}/limits","href":"/api-reference/widget/getcurrencylimits"},{"title":"Get Crypto network fees","openapi":"GET /v3/currencies/network_fees","href":"/api-reference/widget/getnetworkfees"},{"title":"Get Buy transaction","openapi":"GET /v1/transactions/{transactionId}","href":"/api-reference/widget/getbuytransaction"},{"title":"List Buy transactions","openapi":"GET /v1/transactions","href":"/api-reference/widget/getbuytransactions"},{"title":"Get Buy transaction by External identifier","openapi":"GET /v1/transactions/ext/{externalTransactionId}","href":"/api-reference/widget/getbuytransactionbyexternalid"}]},{"group":"Off-ramp","pages":[{"title":"Get Sell quote","openapi":"GET /v3/currencies/{currencyCode}/sell_quote","href":"/api-reference/widget/getsellquote"},{"title":"Get Sell transaction","openapi":"GET /v3/sell_transactions/{transactionId}","href":"/api-reference/widget/getselltransaction"},{"title":"List Sell transactions","openapi":"GET /v3/sell_transactions","href":"/api-reference/widget/getselltransactions"},{"title":"Get Sell transaction by External identifier","openapi":"GET /v3/sell_transactions/ext/{externalTransactionId}","href":"/api-reference/widget/getselltransactionbyexternalid"},{"title":"Cancel Sell transaction","openapi":"DELETE /v3/sell_transactions/{transactionId}","href":"/api-reference/widget/cancelselltransaction"},{"title":"Cancel Sell transaction by externalId","openapi":"DELETE /v3/sell_transactions/ext/{transactionId}","href":"/api-reference/widget/webhooks/cancelselltransactionbyexternalid"}]},{"group":"Data","pages":[{"title":"List supported countries","openapi":"GET /v3/countries","href":"/api-reference/widget/getcountries"},{"title":"List supported currencies","openapi":"GET /v3/currencies","href":"/api-reference/widget/getcurrencies"},{"title":"List currencies (v4)","openapi":"GET /v4/currencies","href":"/api-reference/widget/getv4currencies"},{"title":"List available payment methods","openapi":"GET /payments/v1/payment-method-config","href":"/api-reference/widget/listpaymentmethods"},{"title":"Check Customer's IP address","openapi":"GET /v3/ip_address","href":"/api-reference/widget/getipaddress"}]},{"group":"DeFi tokens","pages":[{"title":"Get DeFi token","openapi":"GET /v1/defi/token","href":"/api-reference/widget/getdefitoken"},{"title":"List DeFi tokens","openapi":"GET /v1/defi/tokens","href":"/api-reference/widget/getdefitokens"}]},{"group":"Virtual Accounts","pages":[{"title":"Get virtual accounts","openapi":"GET /v1/virtual-accounts","href":"/api-reference/widget/getvirtualaccounts"},{"title":"Update on ramp virtual account","openapi":"PATCH /v1/virtual-accounts/onramp/{id}","href":"/api-reference/widget/updateonrampvirtualaccount"},{"title":"Get on ramp transactions","openapi":"GET /v1/virtual-accounts/transactions/onramp","href":"/api-reference/widget/getonramptransactions"},{"title":"Get on ramp transaction","openapi":"GET /v1/virtual-accounts/transactions/onramp/{transactionId}","href":"/api-reference/widget/getonramptransaction"},{"title":"Get off ramp transactions","openapi":"GET /v1/virtual-accounts/transactions/offramp","href":"/api-reference/widget/getofframptransactions"},{"title":"Get off ramp transaction","openapi":"GET /v1/virtual-accounts/transactions/offramp/{transactionId}","href":"/api-reference/widget/getofframptransaction"}]},{"group":"Webhooks","pages":[{"title":"Overview","href":"/api-reference/widget/webhooks/overview"},{"title":"Request signing","href":"/api-reference/widget/webhooks/signature"},{"group":"Buy","pages":[{"title":"transaction_created","openapi":"api-reference/widget/webhooks.openapi.json webhook transaction_created","href":"/api-reference/widget/webhooks/transaction-created"},{"title":"transaction_updated","openapi":"api-reference/widget/webhooks.openapi.json webhook transaction_updated","href":"/api-reference/widget/webhooks/transaction-updated"},{"title":"transaction_failed","openapi":"api-reference/widget/webhooks.openapi.json webhook transaction_failed","href":"/api-reference/widget/webhooks/transaction-failed"}]},{"group":"Sell","pages":[{"title":"sell_transaction_created","openapi":"api-reference/widget/webhooks.openapi.json webhook sell_transaction_created","href":"/api-reference/widget/webhooks/sell-transaction-created"},{"title":"sell_transaction_updated","openapi":"api-reference/widget/webhooks.openapi.json webhook sell_transaction_updated","href":"/api-reference/widget/webhooks/sell-transaction-updated"},{"title":"sell_transaction_failed","openapi":"api-reference/widget/webhooks.openapi.json webhook sell_transaction_failed","href":"/api-reference/widget/webhooks/sell-transaction-failed"},{"title":"sell_transaction_requote_required","openapi":"api-reference/widget/webhooks.openapi.json webhook sell_transaction_requote_required","href":"/api-reference/widget/webhooks/sell-transaction-requote-required"}]},{"group":"Identity","pages":[{"title":"identity_check_updated","openapi":"api-reference/widget/webhooks.openapi.json webhook identity_check_updated","href":"/api-reference/widget/webhooks/identity-check-updated"}]},{"group":"Virtual accounts","pages":[{"title":"virtual_account_status_updated","openapi":"api-reference/widget/webhooks.openapi.json webhook virtual_account_status_updated","href":"/api-reference/widget/webhooks/virtual-account-status-updated"},{"title":"virtual_account_transaction_status_updated","openapi":"api-reference/widget/webhooks.openapi.json webhook virtual_account_transaction_status_updated","href":"/api-reference/widget/webhooks/virtual-account-transaction-status-updated"}]}]}]}]}]},"basePath":"","title":"Simulate bank-transfer settlement - MoonPay Developer Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}