Use this endpoint to send multiple payouts from your business wallet in one request. Each transfer in the batch debits your wallet and credits a different beneficiary account.
Bulk transfers are powerful: always validate input (bank codes, account numbers, amounts) before sending a batch, and use unique references for each row.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PayVessel","description":"PayVessel API documentation for virtual card API, virtual account API, BVN and NIN verification API, credit score API, payments, transfers, and wallets in Nigeria.","colors":{"primary":"#ff6b00","light":"#ff8533","dark":"#cc5500"},"logo":{"light":"https://mintcdn.com/payvessel/QyeQq420aiVxFUf-/logo/light.svg?fit=max\u0026auto=format\u0026n=QyeQq420aiVxFUf-\u0026q=85\u0026s=4da0824cc9f35b850781f06c58e9ca72","dark":"https://mintcdn.com/payvessel/QyeQq420aiVxFUf-/logo/dark.svg?fit=max\u0026auto=format\u0026n=QyeQq420aiVxFUf-\u0026q=85\u0026s=28ea6254576b2b791e2aa2e12a461f42"},"favicon":"https://mintcdn.com/payvessel/lhbec7PBlEuD1R9F/favicon.png?fit=max\u0026auto=format\u0026n=lhbec7PBlEuD1R9F\u0026q=85\u0026s=96a222a9dfbc939e490eea9256aa7d51","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"mailto:support@payvessel.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.payvessel.com"}},"footer":{"socials":{"facebook":"https://www.facebook.com/payvessel","x":"https://x.com/payvessel","instagram":"https://www.instagram.com/payvessel","linkedin":"https://www.linkedin.com/company/payvessel"}},"search":{"prompt":"Search virtual card API, BVN, NIN, credit score..."},"seo":{"metatags":{"og:site_name":"PayVessel API Documentation","og:locale":"en_NG","twitter:card":"summary_large_image","twitter:site":"@payvessel","robots":"index, follow","googlebot":"index, follow","keywords":"PayVessel API, virtual card API, virtual account API, BVN verification API, NIN verification API, credit score API, identity verification API Nigeria, fintech API Nigeria, USD virtual card, Nigerian virtual account"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"payvessel","hasAudioNarration":false,"actualSubdomain":"payvessel","customDomains":["docs.payvessel.com"],"gitSource":{"type":"github","owner":"nex-panther-technologies-ltd","repo":"payvessel-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeafc49d2d002df62e222b6","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Guides","count":83},{"language":"default","tag":"API reference","count":65},{"language":"default","tag":"Value Added Services","count":61},{"language":"default","tag":"Identity Verification","count":26},{"language":"default","tag":"Issuing","count":22},{"language":"default","tag":"eSIM","count":17},{"language":"default","tag":"Flight Booking","count":16},{"language":"default","tag":"Gift Cards","count":15},{"language":"default","tag":"Biller Reseller","count":13},{"language":"default","tag":"Use cases","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"rbac-expansion","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transfers/bulk-transfer","slug":"/api-reference/transfers/bulk-transfer","pageMetadata":{"title":"Bulk Transfer","description":"Initiate multiple wallet transfers in a single batch","openapi":"POST /pms/api/external/request/wallet/bulk-transfer/","href":"/api-reference/transfers/bulk-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: \"Initiate multiple wallet transfers in a single batch\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Badge,CodeBlock,Expandable,Heading,ParamField,Warning}=_components;if(!Badge)_missingMdxReference(`Badge`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint to `,_jsx(_components.strong,{children:`send multiple payouts from your business wallet in one request`}),`. Each transfer in the batch debits your wallet and credits a different beneficiary account.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Bulk transfers are powerful: always validate input (bank codes, account numbers, amounts) before sending a batch, and use unique references for each row.`})}),`\n`,_jsx(Heading,{level:`3`,id:`sandbox`,children:`Sandbox`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://sandbox.payvessel.com/pms/api/external/request/wallet/bulk-transfer/\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-key: YOUR_SANDBOX_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-secret: YOUR_SANDBOX_API_SECRET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{\"batch_reference\":\"PAYROLL_2026_03\",\"transfers\":[{\"amount\":\"15000.00\",\"account_number\":\"0123456789\",\"bank_code\":\"999991\",\"account_name\":\"John Doe\",\"narration\":\"Salary March\",\"reference\":\"PAYROLL_001\"}]}'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsxs(_components.p,{children:[_jsx(Badge,{variant:`success`,children:_jsx(_components.strong,{children:`POST`})}),` `,_jsx(_components.code,{children:`/pms/api/external/request/wallet/bulk-transfer/`})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request Body`}),`\n`,_jsxs(ParamField,{body:`batch_reference`,type:`string`,required:true,id:`param-batch-reference`,children:[_jsx(_components.p,{children:`Unique reference for this bulk batch (for reconciliation)`}),_jsx(Warning,{children:`Must be unique across all your bulk transfers`})]}),`\n`,_jsxs(ParamField,{body:`transfers`,type:`array`,required:true,id:`param-transfers`,children:[_jsx(_components.p,{children:`List of individual transfers in the batch`}),_jsxs(Expandable,{title:`Transfer Object`,children:[_jsx(ParamField,{body:`transfers[].amount`,type:`string`,required:true,id:`param-transfers-amount`,children:_jsxs(_components.p,{children:[`Amount to send for this transfer in the smallest currency unit (e.g. `,_jsx(_components.code,{children:`\"15000.00\"`}),`)`]})}),_jsx(ParamField,{body:`transfers[].account_number`,type:`string`,required:true,id:`param-transfers-account-number`,children:_jsx(_components.p,{children:`Destination bank account number`})}),_jsx(ParamField,{body:`transfers[].bank_code`,type:`string`,required:true,id:`param-transfers-bank-code`,children:_jsx(_components.p,{children:`Destination bank code (see bank list endpoint for available codes)`})}),_jsx(ParamField,{body:`transfers[].account_name`,type:`string`,id:`param-transfers-account-name`,children:_jsx(_components.p,{children:`Optional account name for your own records`})}),_jsx(ParamField,{body:`transfers[].narration`,type:`string`,id:`param-transfers-narration`,children:_jsx(_components.p,{children:`Description that may appear on the beneficiary’s statement`})}),_jsxs(ParamField,{body:`transfers[].reference`,type:`string`,required:true,id:`param-transfers-reference`,children:[_jsx(_components.p,{children:`Unique reference for this specific transfer in the batch`}),_jsx(Warning,{children:`Must be unique across all transfers in this batch`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`example-request`,children:`Example request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`21`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"batch_reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PAYROLL_2026_03\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"transfers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"15000.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0123456789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"999991\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"narration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"March salary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PAYROLL_2026_03_EMP001\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20000.00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0987654321\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"120001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane Smith\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"narration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"March salary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PAYROLL_2026_03_EMP002\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`example-curl`,children:`Example cURL`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`25`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`25`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.payvessel.com/pms/api/external/request/wallet/bulk-transfer/\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-secret: YOUR_API_SECRET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"batch_reference\": \"PAYROLL_2026_03\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"transfers\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": \"15000.00\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"account_number\": \"0123456789\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"bank_code\": \"999991\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"account_name\": \"John Doe\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"narration\": \"March salary\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reference\": \"PAYROLL_2026_03_EMP001\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": \"20000.00\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"account_number\": \"0987654321\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"bank_code\": \"120001\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"account_name\": \"Jane Smith\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"narration\": \"March salary\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reference\": \"PAYROLL_2026_03_EMP002\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`On success you receive high‑level information about the batch:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bulk transfer initiated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"batch_reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PAYROLL_2026_03\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"successful_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failed_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"35000.00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`For detailed per‑transfer status, use the `,_jsx(_components.strong,{children:`transfer status`}),` and `,_jsx(_components.strong,{children:`wallet transactions`}),` endpoints.`]})]})}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":"Bulk Transfer","description":"Initiate multiple wallet transfers in a single batch","openapi":"POST /pms/api/external/request/wallet/bulk-transfer/","href":"/api-reference/transfers/bulk-transfer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Sandbox","slug":"sandbox","depth":3,"children":[]},{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Request Body","slug":"request-body","depth":2,"children":[{"title":"Example request","slug":"example-request","depth":3,"children":[]},{"title":"Example cURL","slug":"example-curl","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Bulk Transfer","description":"Initiate multiple wallet transfers in a single batch","requestBody":"95f57f0c-b8cf-4c74-a365-55856b3e7daf","responses":{"200":"ff0ccbc2-f4b7-46ec-ac56-a6b9f5029623"},"tags":["Transfers"],"parameters":["e4b34af3-e058-4bb2-8f7a-02589d8fa117","349d4921-8637-4122-972a-833116b66f77","6b9e0051-8fe8-45de-a52a-3c4d5e8c7833"],"method":"post","type":"path","servers":["070febbf-78f5-4c90-abb1-7a53bc4d5fa3","a1d0d258-d88b-4285-a720-4fdf22e6d579"],"security":["c83cf5d7-7a8f-4a93-b2d7-cac256a8fd67"],"path":"/pms/api/external/request/wallet/bulk-transfer/","baseUrlOptions":["https://api.payvessel.com","https://sandbox.payvessel.com"],"title":"Bulk Transfer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e4b34af3-e058-4bb2-8f7a-02589d8fa117":{"name":"api-key","in":"header","description":"Your Payvessel public API key","required":true,"schema":{"type":"string","isRequired":true,"description":"Your Payvessel public API key","uniqueKey":"","typeLabel":"string"}},"349d4921-8637-4122-972a-833116b66f77":{"name":"api-secret","in":"header","description":"Your Payvessel secret","required":true,"schema":{"type":"string","isRequired":true,"description":"Your Payvessel secret","uniqueKey":"","typeLabel":"string"}},"6b9e0051-8fe8-45de-a52a-3c4d5e8c7833":{"name":"Content-Type","in":"header","description":"Request content type","required":true,"schema":{"type":"string","enum":["application/json"],"isRequired":true,"description":"Request content type","uniqueKey":"","typeLabel":"enum\u003cstring>"},"example":"application/json"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["batch_reference","transfers"],"properties":{"batch_reference":{"type":"string","description":"Unique reference for the bulk batch","isRequired":true,"uniqueKey":"batch_reference","typeLabel":"string"},"transfers":{"type":"array","items":{"type":"object","required":["amount","account_number","bank_code","reference"],"properties":{"amount":{"type":"string","description":"Amount for this transfer","isRequired":true,"uniqueKey":"transfers.items.[INDEX].amount","typeLabel":"string"},"account_number":{"type":"string","description":"Destination account number","isRequired":true,"uniqueKey":"transfers.items.[INDEX].account_number","typeLabel":"string"},"bank_code":{"type":"string","description":"Destination bank code","isRequired":true,"uniqueKey":"transfers.items.[INDEX].bank_code","typeLabel":"string"},"reference":{"type":"string","description":"Unique reference for this transfer","isRequired":true,"uniqueKey":"transfers.items.[INDEX].reference","typeLabel":"string"},"account_name":{"type":"string","description":"Optional account name","uniqueKey":"transfers.items.[INDEX].account_name","typeLabel":"string"},"narration":{"type":"string","description":"Transfer description","uniqueKey":"transfers.items.[INDEX].narration","typeLabel":"string"}},"uniqueKey":"transfers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"transfers","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"batch_reference":"PAYROLL_2026_03","transfers":[{"amount":"15000.00","account_number":"0123456789","bank_code":"999991","account_name":"John Doe","narration":"March salary","reference":"PAYROLL_2026_03_EMP001"}]},"examples":{"Example":{"title":"Example","value":{"batch_reference":"PAYROLL_2026_03","transfers":[{"amount":"15000.00","account_number":"0123456789","bank_code":"999991","account_name":"John Doe","narration":"March salary","reference":"PAYROLL_2026_03_EMP001"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ff0ccbc2-f4b7-46ec-ac56-a6b9f5029623":{"description":"Bulk transfer initiated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"boolean","description":"Request status","uniqueKey":"status","typeLabel":"boolean"},"message":{"type":"string","description":"Response message","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"Bulk transfer result data","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":true,"message":"\u003cstring>","data":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c83cf5d7-7a8f-4a93-b2d7-cac256a8fd67":{}},"servers":{"070febbf-78f5-4c90-abb1-7a53bc4d5fa3":{"url":"https://api.payvessel.com"},"a1d0d258-d88b-4285-a720-4fdf22e6d579":{"url":"https://sandbox.payvessel.com"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"payvessel","siteName":"PayVessel","title":"Bulk Transfer - PayVessel","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-24T02:31:19.339Z","originalFileLocation":"api-reference/transfers/bulk-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=\"system\"}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=\"Initiate multiple wallet transfers in a single batch\">\u003cmeta data-mint-head name=\"keywords\" content=\"PayVessel API, virtual card API, virtual account API, BVN verification API, NIN verification API, credit score API, identity verification API Nigeria, fintech API Nigeria, USD virtual card, Nigerian virtual account\">\u003cmeta data-mint-head name=\"application-name\" content=\"PayVessel\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_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/payvessel/U2TKO-xM2sH_8maJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bulk Transfer - PayVessel\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate multiple wallet transfers in a single batch\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PayVessel API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://payvessel.mintlify.site/_mintlify/api/og/v2?division=Transfer\u0026amp;title=Bulk+Transfer\u0026amp;description=Initiate+multiple+wallet+transfers+in+a+single+batch\u0026amp;theme=d6def137ae8ad9f7001e98f0\u0026amp;signature=8f77bbdb57932046f18ed925f016dfc93a6abe9bd91d14f3a18a5a34a498577f\">\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=\"Bulk Transfer - PayVessel\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate multiple wallet transfers in a single batch\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://payvessel.mintlify.site/_mintlify/api/og/v2?division=Transfer\u0026amp;title=Bulk+Transfer\u0026amp;description=Initiate+multiple+wallet+transfers+in+a+single+batch\u0026amp;theme=d6def137ae8ad9f7001e98f0\u0026amp;signature=8f77bbdb57932046f18ed925f016dfc93a6abe9bd91d14f3a18a5a34a498577f\">\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/payvessel/U2TKO-xM2sH_8maJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PayVessel\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff6b00\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_NG\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.payvessel.com/api-reference/transfers/bulk-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/transfers/bulk-transfer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.payvessel.com/#organization\",\"name\":\"PayVessel\",\"url\":\"https://docs.payvessel.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/payvessel/QyeQq420aiVxFUf-/logo/light.svg?fit=max\u0026auto=format\u0026n=QyeQq420aiVxFUf-\u0026q=85\u0026s=4da0824cc9f35b850781f06c58e9ca72\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.payvessel.com#website\",\"name\":\"PayVessel\",\"url\":\"https://docs.payvessel.com\",\"publisher\":{\"@id\":\"https://docs.payvessel.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer#webpage\",\"url\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer\",\"name\":\"Bulk Transfer\",\"description\":\"Initiate multiple wallet transfers in a single batch\",\"dateModified\":\"2026-05-24T02:31:19.339Z\",\"isPartOf\":{\"@id\":\"https://docs.payvessel.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transfer\",\"item\":\"https://docs.payvessel.com/api-reference/transfers/get-bank-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bulk Transfer\",\"item\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer#apireference\",\"headline\":\"Bulk Transfer\",\"name\":\"Bulk Transfer\",\"description\":\"Initiate multiple wallet transfers in a single batch\",\"url\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.payvessel.com/api-reference/transfers/bulk-transfer#webpage\"},\"dateModified\":\"2026-05-24T02:31:19.339Z\",\"publisher\":{\"@id\":\"https://docs.payvessel.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.payvessel.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PayVessel\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PayVessel","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Getting Started","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Transactions","pages":[{"title":"Initialize Payment","openapi":"POST /pms/transactions/initialize/","href":"/api-reference/transactions/initialize-payment"},{"title":"Verify Payment","openapi":"api-reference/openapi.json GET /pms/transactions/{reference}/confirm/","href":"/api-reference/transactions/verify-payment"}]},{"group":"Virtual Accounts","pages":[{"title":"Create Virtual Account","openapi":"api-reference/openapi.json POST /pms/api/external/request/customerReservedAccount/","href":"/api-reference/virtual-accounts/create-virtual-account"},{"title":"Get Virtual Account","openapi":"api-reference/openapi.json GET /pms/api/external/request/virtual-account/{businessid}/{account}/","href":"/api-reference/virtual-accounts/get-virtual-account"},{"title":"Update Virtual Account","openapi":"api-reference/openapi.json PUT /pms/api/external/request/customerReservedAccount/{account_number}/","href":"/api-reference/virtual-accounts/update-virtual-account"}]},{"group":"Issuing","pages":[{"title":"Create a Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/","href":"/api-reference/virtual-cards/create-customer-card"},{"title":"Get all Cards","openapi":"api-reference/openapi.json GET /pms/api/external/request/virtual-cards/","href":"/api-reference/virtual-cards/list-cards"},{"title":"Get a Card","openapi":"api-reference/openapi.json GET /pms/api/external/request/virtual-cards/{card_id}/","href":"/api-reference/virtual-cards/get-card"},{"title":"Fund a Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/fund/","href":"/api-reference/virtual-cards/fund-card"},{"title":"Withdraw from a Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/withdraw/","href":"/api-reference/virtual-cards/withdraw-card"},{"title":"Get Card Transactions","openapi":"api-reference/openapi.json GET /pms/api/external/request/virtual-cards/{card_id}/transactions/","href":"/api-reference/virtual-cards/list-transactions"},{"title":"Simulate Card Transaction","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/mock-transaction/","href":"/api-reference/virtual-cards/mock-transaction"},{"title":"Freeze a Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/freeze/","href":"/api-reference/virtual-cards/freeze-card"},{"title":"Unfreeze a Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/unfreeze/","href":"/api-reference/virtual-cards/unfreeze-card"},{"title":"Terminate Card","openapi":"api-reference/openapi.json POST /pms/api/external/request/virtual-cards/{card_id}/terminate/","href":"/api-reference/virtual-cards/terminate-card"}]},{"group":"Transfer","pages":[{"title":"Get Bank List","openapi":"GET /pms/api/external/request/wallet/banks/","href":"/api-reference/transfers/get-bank-list"},{"title":"Validate Account","openapi":"POST /pms/api/external/request/wallet/validate-account/","href":"/api-reference/transfers/validate-account"},{"title":"Initiate Transfer","description":"Send money from your managed wallet to a bank account","openapi":"POST /pms/api/external/request/wallet/transfer/","href":"/api-reference/transfers/initiate-transfer"},{"title":"Bulk Transfer","openapi":"POST /pms/api/external/request/wallet/bulk-transfer/","href":"/api-reference/transfers/bulk-transfer"},{"title":"Transfer Status","description":"Check the status of a previously initiated transfer","openapi":"POST /pms/api/external/request/wallet/transfer-status/","href":"/api-reference/transfers/transfer-status"}]},{"group":"Wallets","pages":[{"title":"Wallet Balance","openapi":"GET /pms/api/external/request/wallet/balance/","href":"/api-reference/wallets/wallet-balance"},{"title":"Get Wallets","openapi":"GET /pms/api/external/request/wallet/get-or-create/","href":"/api-reference/wallets/get-wallets"}]},{"group":"Identity Verification","pages":[{"title":"Verify BVN (Basic)","openapi":"POST /api/v1/merchant/bvn/basic","href":"/api-reference/verification/basic-bvn-verification"},{"title":"Verify BVN (Enhanced)","openapi":"POST /api/v1/merchant/bvn/enhanced","href":"/api-reference/verification/enhanced-bvn-verification"},{"title":"Verify NIN (Basic)","openapi":"POST /api/v1/merchant/nin/basic","href":"/api-reference/verification/basic-nin-verification"},{"title":"Verify NIN (Enhanced)","openapi":"POST /api/v1/merchant/nin/enhanced","href":"/api-reference/verification/enhanced-nin-verification"},{"title":"Verify Driver's License","openapi":"POST /api/v1/merchant/documents/drivers-license","href":"/api-reference/verification/drivers-license-verification"},{"title":"Verify Voter's Card","openapi":"POST /api/v1/merchant/documents/voters-card","href":"/api-reference/verification/voters-card-verification"},{"title":"Verify International Passport","openapi":"POST /api/v1/merchant/documents/international-passport","href":"/api-reference/verification/international-passport-verification"},{"title":"Compare Faces","openapi":"POST /api/v1/merchant/face/compare","href":"/api-reference/verification/merchant-face"},{"title":"BVN and Account","openapi":"POST /api/v1/merchant/bank/verify-account","href":"/api-reference/verification/merchant-bank-account"},{"title":"Blacklist Query","openapi":"POST /api/v1/merchant/risk/blacklist/query","href":"/api-reference/verification/blacklist-query"},{"title":"Credit Score Query","openapi":"POST /api/v1/merchant/risk/credit-score/query","href":"/api-reference/verification/credit-score-query"},{"title":"Loan Feature Query","openapi":"POST /api/v1/merchant/risk/loan-feature/query","href":"/api-reference/verification/loan-feature-query"}]},{"group":"Value Added Services","pages":[{"group":"Biller Reseller","pages":[{"title":"Get Billers","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/biller-reseller/billers","href":"/api-reference/biller-reseller/get-billers"},{"title":"Get Biller Items","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/biller-reseller/billers/{biller_id}/items","href":"/api-reference/biller-reseller/get-biller-items"},{"title":"Validate Recharge Account","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/biller-reseller/validate-account","href":"/api-reference/biller-reseller/validate-account"},{"title":"Create Order","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/biller-reseller/orders","href":"/api-reference/biller-reseller/create-order"},{"title":"Get Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/biller-reseller/orders/{order_id}","href":"/api-reference/biller-reseller/get-order"},{"title":"Verify Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/biller-reseller/orders/verify/{reference}","href":"/api-reference/biller-reseller/verify-order"}]},{"group":"eSIM","pages":[{"title":"List Regions","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/regions","href":"/api-reference/esim/list-regions"},{"title":"List Packages","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/packages","href":"/api-reference/esim/list-packages"},{"title":"List Top-Up Packages","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/topup-packages","href":"/api-reference/esim/list-topup-packages"},{"title":"Create eSIM Order","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/esim/orders","href":"/api-reference/esim/create-order"},{"title":"Get eSIM Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/orders/{order_id}","href":"/api-reference/esim/get-order"},{"title":"Create eSIM Top-Up","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/esim/topups","href":"/api-reference/esim/create-topup"},{"title":"Get eSIM Top-Up","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/topups/{topup_id}","href":"/api-reference/esim/get-topup"},{"title":"List eSIM Orders","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/esim/orders","href":"/api-reference/esim/list-orders"}]},{"group":"Gift Cards","pages":[{"title":"List Countries","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/countries","href":"/api-reference/gift-cards/list-countries"},{"title":"Get Country","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/countries/{country_id}","href":"/api-reference/gift-cards/get-country"},{"title":"List Operators","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/countries/{country_code}/operators","href":"/api-reference/gift-cards/list-operators"},{"title":"List Products","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/operators/{operator_id}/products","href":"/api-reference/gift-cards/list-products"},{"title":"Purchase Gift Card","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/gift-cards/orders","href":"/api-reference/gift-cards/purchase"},{"title":"Get Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/orders/{order_id}","href":"/api-reference/gift-cards/get-order"},{"title":"Verify Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/gift-cards/orders/verify/{reference}","href":"/api-reference/gift-cards/verify-order"}]},{"group":"Flight Booking","pages":[{"title":"List Airports","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/flight/airports","href":"/api-reference/flight/airports"},{"title":"Search Flights","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/flight/search","href":"/api-reference/flight/search"},{"title":"Create Flight Quote","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/flight/quotes","href":"/api-reference/flight/create-quote"},{"title":"Create Flight Order","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/flight/orders","href":"/api-reference/flight/create-order"},{"title":"Cancel Flight Order","openapi":"api-reference/vaas-services-openapi.json POST /vaas/api/v1/flight/orders/{order_id}/cancel","href":"/api-reference/flight/cancel-order"},{"title":"List Flight Orders","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/flight/orders","href":"/api-reference/flight/list-orders"},{"title":"Get Flight Order","openapi":"api-reference/vaas-services-openapi.json GET /vaas/api/v1/flight/orders/{order_id}","href":"/api-reference/flight/get-order"}]}]},{"group":"Webhook","pages":[{"title":"Webhook Overview","href":"/api-reference/webhook/overview"},{"title":"Verifying Webhooks","href":"/api-reference/webhook/verifying-webhooks"}]}]}]},"basePath":"","title":"Bulk Transfer - PayVessel","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}