[{"data":1,"prerenderedAt":1372},["ShallowReactive",2],{"docs-navigation":3,"page-\u002Fza\u002Fdisbursements\u002Ftransfers\u002Fsingle-transfers":787},[4,20,48,169,226,273,326,330,370,442,641,738],{"title":5,"path":6,"stem":7,"children":8,"page":19},"Shared","\u002F_shared","_shared",[9],{"title":10,"path":11,"stem":12,"children":13,"page":19},"Payments","\u002F_shared\u002Fpayments","_shared\u002Fpayments",[14],{"title":15,"path":16,"stem":17,"markets":18},"Webhook confirmation","\u002F_shared\u002Fpayments\u002F_webhook-note","_shared\u002Fpayments\u002F_webhook-note",null,false,{"title":21,"path":22,"stem":23,"children":24},"Api","\u002Fapi","api",[25,28,32,36,40,44],{"title":26,"path":22,"stem":27,"markets":18},"API Reference","api\u002Findex",{"title":29,"path":30,"stem":31,"markets":18},"Authentication","\u002Fapi\u002Fauthentication","api\u002Fauthentication",{"title":33,"path":34,"stem":35,"markets":18},"Errors","\u002Fapi\u002Ferrors","api\u002Ferrors",{"title":37,"path":38,"stem":39,"markets":18},"Pagination","\u002Fapi\u002Fpagination","api\u002Fpagination",{"title":41,"path":42,"stem":43,"markets":18},"Rate Limits","\u002Fapi\u002Frate-limits","api\u002Frate-limits",{"title":45,"path":46,"stem":47,"markets":18},"Supported Currencies","\u002Fapi\u002Fsupported-currencies","api\u002Fsupported-currencies",{"title":49,"path":50,"stem":51,"children":52},"Commerce","\u002Fcommerce","commerce",[53,56,64,85,108,122,132,151],{"title":49,"path":50,"stem":54,"markets":18,"order":55},"commerce\u002Findex",0,{"title":57,"path":58,"stem":59,"children":60,"markets":18,"order":63},"Get started","\u002Fcommerce\u002Fget-started","commerce\u002F1.get-started\u002Findex",[61],{"title":62,"path":58,"stem":59,"markets":18,"order":55},"Build Your First Store",1,{"title":65,"markets":18,"order":66,"path":67,"stem":68,"children":69},"Payment Pages",2,"\u002Fcommerce\u002Fpayment-pages","commerce\u002F2.payment-pages\u002Findex",[70,71,76,80],{"title":65,"path":67,"stem":68,"markets":18,"order":55},{"title":72,"path":73,"stem":74,"markets":18,"order":75},"Add Products to a Page","\u002Fcommerce\u002Fpayment-pages\u002Fadd-products","commerce\u002F2.payment-pages\u002Fadd-products",4,{"title":77,"path":78,"stem":79,"markets":18,"order":66},"Create a Payment Page","\u002Fcommerce\u002Fpayment-pages\u002Fcreate","commerce\u002F2.payment-pages\u002Fcreate",{"title":81,"path":82,"stem":83,"markets":18,"order":84},"Manage Payment Pages","\u002Fcommerce\u002Fpayment-pages\u002Fmanage","commerce\u002F2.payment-pages\u002Fmanage",3,{"title":86,"markets":18,"order":84,"path":87,"stem":88,"children":89},"Payment Requests","\u002Fcommerce\u002Fpayment-requests","commerce\u002F3.payment-requests\u002Findex",[90,91,95,99,103],{"title":86,"path":87,"stem":88,"markets":18,"order":55},{"title":92,"path":93,"stem":94,"markets":18,"order":66},"Create a Payment Request","\u002Fcommerce\u002Fpayment-requests\u002Fcreate","commerce\u002F3.payment-requests\u002Fcreate",{"title":96,"path":97,"stem":98,"markets":18,"order":75},"Manage Payment Requests","\u002Fcommerce\u002Fpayment-requests\u002Fmanage","commerce\u002F3.payment-requests\u002Fmanage",{"title":100,"path":101,"stem":102,"markets":18,"order":84},"Notify and Finalize Requests","\u002Fcommerce\u002Fpayment-requests\u002Fnotify-and-finalize","commerce\u002F3.payment-requests\u002Fnotify-and-finalize",{"title":104,"path":105,"stem":106,"markets":18,"order":107},"Verify a Payment Request","\u002Fcommerce\u002Fpayment-requests\u002Fverify","commerce\u002F3.payment-requests\u002Fverify",5,{"title":109,"markets":18,"order":75,"path":110,"stem":111,"children":112},"Products","\u002Fcommerce\u002Fproducts","commerce\u002F4.products\u002Findex",[113,114,118],{"title":109,"path":110,"stem":111,"markets":18,"order":55},{"title":115,"path":116,"stem":117,"markets":18,"order":66},"Create a Product","\u002Fcommerce\u002Fproducts\u002Fcreate","commerce\u002F4.products\u002Fcreate",{"title":119,"path":120,"stem":121,"markets":18,"order":84},"Manage Products","\u002Fcommerce\u002Fproducts\u002Fmanage","commerce\u002F4.products\u002Fmanage",{"title":123,"path":124,"stem":125,"children":126,"markets":18,"order":107},"Orders","\u002Fcommerce\u002Forders","commerce\u002F5.orders\u002Findex",[127,128],{"title":123,"path":124,"stem":125,"markets":18,"order":55},{"title":129,"path":130,"stem":131,"markets":18,"order":66},"Manage Orders","\u002Fcommerce\u002Forders\u002Fmanage","commerce\u002F5.orders\u002Fmanage",{"title":133,"markets":18,"order":134,"path":135,"stem":136,"children":137},"Storefronts",6,"\u002Fcommerce\u002Fstorefronts","commerce\u002F6.storefronts\u002Findex",[138,139,143,147],{"title":133,"path":135,"stem":136,"markets":18,"order":55},{"title":140,"path":141,"stem":142,"markets":18,"order":66},"Create a Storefront","\u002Fcommerce\u002Fstorefronts\u002Fcreate","commerce\u002F6.storefronts\u002Fcreate",{"title":144,"path":145,"stem":146,"markets":18,"order":84},"Publish and Manage Storefronts","\u002Fcommerce\u002Fstorefronts\u002Fmanage","commerce\u002F6.storefronts\u002Fmanage",{"title":148,"path":149,"stem":150,"markets":18,"order":75},"Products and Orders","\u002Fcommerce\u002Fstorefronts\u002Fproducts-and-orders","commerce\u002F6.storefronts\u002Fproducts-and-orders",{"title":152,"markets":18,"order":153,"path":154,"stem":155,"children":156,"page":19},"Concepts",7,"\u002Fcommerce\u002Fconcepts","commerce\u002F7.concepts",[157,161,165],{"title":158,"path":159,"stem":160,"markets":18,"order":84},"No-code Builder vs API Approach","\u002Fcommerce\u002Fconcepts\u002Fnocode-vs-api","commerce\u002F7.concepts\u002Fnocode-vs-api",{"title":162,"path":163,"stem":164,"markets":18,"order":66},"Commerce Order Lifecycle","\u002Fcommerce\u002Fconcepts\u002Forder-lifecycle","commerce\u002F7.concepts\u002Forder-lifecycle",{"title":166,"path":167,"stem":168,"markets":18,"order":63},"Payment Pages vs Payment Requests","\u002Fcommerce\u002Fconcepts\u002Fpayment-pages-vs-requests","commerce\u002F7.concepts\u002Fpayment-pages-vs-requests",{"title":170,"path":171,"stem":172,"children":173},"Developer Tools","\u002Fdeveloper-tools","developer-tools",[174,176,193,197,214,218,222],{"title":170,"path":171,"stem":175,"markets":18,"order":55},"developer-tools\u002Findex",{"title":177,"markets":18,"order":63,"path":178,"stem":179,"children":180,"page":19},"Integration toolkit","\u002Fdeveloper-tools\u002Fintegration","developer-tools\u002F1.integration",[181,185,189],{"title":182,"path":183,"stem":184,"markets":18,"order":63},"API keys","\u002Fdeveloper-tools\u002Fintegration\u002Fapi-keys","developer-tools\u002F1.integration\u002Fapi-keys",{"title":186,"path":187,"stem":188,"markets":18,"order":84},"Test payments","\u002Fdeveloper-tools\u002Fintegration\u002Ftest-payments","developer-tools\u002F1.integration\u002Ftest-payments",{"title":190,"path":191,"stem":192,"markets":18,"order":66},"Webhooks","\u002Fdeveloper-tools\u002Fintegration\u002Fwebhooks","developer-tools\u002F1.integration\u002Fwebhooks",{"title":194,"path":195,"stem":196,"markets":18,"order":66},"InlineJS","\u002Fdeveloper-tools\u002Finline-js","developer-tools\u002F2.inline-js",{"title":198,"markets":18,"order":84,"path":199,"stem":200,"children":201,"page":19},"Mobile SDKs","\u002Fdeveloper-tools\u002Fmobile-sdks","developer-tools\u002F3.mobile-sdks",[202,206,210],{"title":203,"path":204,"stem":205,"markets":18,"order":63},"Android SDK","\u002Fdeveloper-tools\u002Fmobile-sdks\u002Fandroid","developer-tools\u002F3.mobile-sdks\u002Fandroid",{"title":207,"path":208,"stem":209,"markets":18,"order":84},"Flutter SDK","\u002Fdeveloper-tools\u002Fmobile-sdks\u002Fflutter","developer-tools\u002F3.mobile-sdks\u002Fflutter",{"title":211,"path":212,"stem":213,"markets":18,"order":66},"iOS SDK","\u002Fdeveloper-tools\u002Fmobile-sdks\u002Fios","developer-tools\u002F3.mobile-sdks\u002Fios",{"title":215,"path":216,"stem":217,"markets":18,"order":75},"Server SDKs","\u002Fdeveloper-tools\u002Fserver-sdks","developer-tools\u002F4.server-sdks",{"title":219,"path":220,"stem":221,"markets":18,"order":107},"Plugins","\u002Fdeveloper-tools\u002Fplugins","developer-tools\u002F5.plugins",{"title":223,"path":224,"stem":225,"markets":18,"order":134},"MCP Server","\u002Fdeveloper-tools\u002Fmcp-server","developer-tools\u002F6.mcp-server",{"title":227,"path":228,"stem":229,"children":230},"Disbursements","\u002Fdisbursements","disbursements",[231,233,236],{"title":227,"path":228,"stem":232,"markets":18,"order":55},"disbursements\u002Findex",{"title":57,"path":234,"stem":235,"markets":18,"order":63},"\u002Fdisbursements\u002Fget-started","disbursements\u002F1.get-started",{"title":237,"markets":18,"order":66,"path":238,"stem":239,"children":240,"page":19},"Transfers","\u002Fdisbursements\u002Ftransfers","disbursements\u002Ftransfers",[241,245,253,257,261,265,269],{"title":242,"path":243,"stem":244,"markets":18},"Transfer recipients","\u002Fdisbursements\u002Ftransfers\u002Frecipients","disbursements\u002Ftransfers\u002F01.recipients",{"title":246,"path":247,"stem":248,"markets":249},"Verify an account number","\u002Fdisbursements\u002Ftransfers\u002Fverify-account","disbursements\u002Ftransfers\u002F02.verify-account",[250,251,252],"ng","gh","za",{"title":254,"path":255,"stem":256,"markets":18},"Send money to a single recipient","\u002Fdisbursements\u002Ftransfers\u002Fsingle-transfers","disbursements\u002Ftransfers\u002F03.single-transfers",{"title":258,"path":259,"stem":260,"markets":18},"Send money to multiple recipients","\u002Fdisbursements\u002Ftransfers\u002Fbulk-transfers","disbursements\u002Ftransfers\u002F04.bulk-transfers",{"title":262,"path":263,"stem":264,"markets":18},"Check your balance","\u002Fdisbursements\u002Ftransfers\u002Fbalance-management","disbursements\u002Ftransfers\u002F05.balance-management",{"title":266,"path":267,"stem":268,"markets":18},"Transfer approval","\u002Fdisbursements\u002Ftransfers\u002Ftransfer-approval","disbursements\u002Ftransfers\u002F06.transfer-approval",{"title":270,"path":271,"stem":272,"markets":18},"How transfers work","\u002Fdisbursements\u002Ftransfers\u002Fhow-transfers-work","disbursements\u002Ftransfers\u002F07.how-transfers-work",{"title":274,"path":275,"stem":251,"children":276,"page":19},"Gh","\u002Fgh",[277],{"title":10,"path":278,"stem":279,"children":280,"markets":18,"order":55},"\u002Fgh\u002Fpayments","gh\u002Fpayments\u002Findex",[281,282,316],{"title":10,"path":278,"stem":279,"markets":18,"order":55},{"title":283,"markets":18,"order":66,"path":284,"stem":285,"children":286},"Payment channels","\u002Fgh\u002Fpayments\u002Fchannels","gh\u002Fpayments\u002Fchannels\u002Findex",[287,289,294,298,308,312],{"title":288,"path":284,"stem":285,"markets":18,"order":55},"Overview",{"title":290,"path":291,"stem":292,"markets":18,"order":293},"Apple Pay","\u002Fgh\u002Fpayments\u002Fchannels\u002Fapple-pay","gh\u002Fpayments\u002Fchannels\u002Fapple-pay",98,{"title":295,"path":296,"stem":297,"markets":18,"order":66},"Cards","\u002Fgh\u002Fpayments\u002Fchannels\u002Fcards","gh\u002Fpayments\u002Fchannels\u002Fcards",{"title":299,"markets":18,"order":75,"path":300,"stem":301,"children":302},"Dedicated Virtual Accounts","\u002Fgh\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts","gh\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts\u002Findex",[303,304],{"title":299,"path":300,"stem":301,"markets":18},{"title":305,"path":306,"stem":307,"markets":18},"Create and Assign Dedicated Virtual Accounts","\u002Fgh\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts\u002Fcreate-and-assign-dedicated-virtual-accounts","gh\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts\u002Fcreate-and-assign-dedicated-virtual-accounts",{"title":309,"path":310,"stem":311,"markets":18,"order":63},"Mobile Money","\u002Fgh\u002Fpayments\u002Fchannels\u002Fmobile-money","gh\u002Fpayments\u002Fchannels\u002Fmobile-money",{"title":313,"path":314,"stem":315,"markets":18,"order":84},"Pay with Transfer","\u002Fgh\u002Fpayments\u002Fchannels\u002Fpwt","gh\u002Fpayments\u002Fchannels\u002Fpwt",{"title":317,"path":318,"stem":319,"children":320,"markets":18,"order":107},"In-person","\u002Fgh\u002Fpayments\u002Fin-person","gh\u002Fpayments\u002Fin-person\u002Findex",[321,322],{"title":288,"path":318,"stem":319,"markets":18,"order":55},{"title":323,"path":324,"stem":325,"markets":18,"order":63},"Virtual Terminal","\u002Fgh\u002Fpayments\u002Fin-person\u002Fvirtual-terminal","gh\u002Fpayments\u002Fin-person\u002Fvirtual-terminal",{"title":327,"path":328,"stem":329,"markets":18},"Home","\u002F","index",{"title":331,"path":332,"stem":333,"children":334,"page":19},"Ke","\u002Fke","ke",[335],{"title":10,"path":336,"stem":337,"children":338,"markets":18,"order":55},"\u002Fke\u002Fpayments","ke\u002Fpayments\u002Findex",[339,340,362],{"title":10,"path":336,"stem":337,"markets":18,"order":55},{"title":283,"markets":18,"order":66,"path":341,"stem":342,"children":343},"\u002Fke\u002Fpayments\u002Fchannels","ke\u002Fpayments\u002Fchannels\u002Findex",[344,345,348,351,354,358],{"title":288,"path":341,"stem":342,"markets":18,"order":55},{"title":290,"path":346,"stem":347,"markets":18,"order":293},"\u002Fke\u002Fpayments\u002Fchannels\u002Fapple-pay","ke\u002Fpayments\u002Fchannels\u002Fapple-pay",{"title":295,"path":349,"stem":350,"markets":18,"order":84},"\u002Fke\u002Fpayments\u002Fchannels\u002Fcards","ke\u002Fpayments\u002Fchannels\u002Fcards",{"title":309,"path":352,"stem":353,"markets":18,"order":66},"\u002Fke\u002Fpayments\u002Fchannels\u002Fmobile-money","ke\u002Fpayments\u002Fchannels\u002Fmobile-money",{"title":355,"path":356,"stem":357,"markets":18,"order":63},"M-PESA","\u002Fke\u002Fpayments\u002Fchannels\u002Fmpesa","ke\u002Fpayments\u002Fchannels\u002Fmpesa",{"title":359,"path":360,"stem":361,"markets":18,"order":75},"PesaLink","\u002Fke\u002Fpayments\u002Fchannels\u002Fpesalink","ke\u002Fpayments\u002Fchannels\u002Fpesalink",{"title":317,"path":363,"stem":364,"children":365,"markets":18,"order":107},"\u002Fke\u002Fpayments\u002Fin-person","ke\u002Fpayments\u002Fin-person\u002Findex",[366,367],{"title":288,"path":363,"stem":364,"markets":18,"order":55},{"title":323,"path":368,"stem":369,"markets":18,"order":63},"\u002Fke\u002Fpayments\u002Fin-person\u002Fvirtual-terminal","ke\u002Fpayments\u002Fin-person\u002Fvirtual-terminal",{"title":371,"path":372,"stem":373,"children":374},"Operations","\u002Foperations","operations",[375,377,386,395,404,421],{"title":371,"path":372,"stem":376,"markets":18,"order":55},"operations\u002Findex",{"title":378,"markets":18,"order":84,"path":379,"stem":380,"children":381,"page":19},"Refunds","\u002Foperations\u002Frefunds","operations\u002F3.refunds",[382],{"title":383,"path":384,"stem":385,"markets":18},"How to issue a refund","\u002Foperations\u002Frefunds\u002Fprocess-a-refund","operations\u002F3.refunds\u002Fprocess-a-refund",{"title":387,"markets":18,"order":75,"path":388,"stem":389,"children":390,"page":19},"Disputes","\u002Foperations\u002Fdisputes","operations\u002F4.disputes",[391],{"title":392,"path":393,"stem":394,"markets":18},"How to manage disputes","\u002Foperations\u002Fdisputes\u002Fmanage-disputes","operations\u002F4.disputes\u002Fmanage-disputes",{"title":396,"markets":18,"order":107,"path":397,"stem":398,"children":399,"page":19},"Settlements","\u002Foperations\u002Fsettlements","operations\u002F5.settlements",[400],{"title":401,"path":402,"stem":403,"markets":18},"Settlements reference","\u002Foperations\u002Fsettlements\u002Fview-settlements","operations\u002F5.settlements\u002Fview-settlements",{"title":405,"markets":18,"order":134,"path":406,"stem":407,"children":408,"page":19},"Verification","\u002Foperations\u002Fverification","operations\u002F6.verification",[409,413,417],{"title":410,"path":411,"stem":412,"markets":18,"order":84},"Resolve BVN","\u002Foperations\u002Fverification\u002Fresolve-bvn","operations\u002F6.verification\u002Fresolve-bvn",{"title":414,"path":415,"stem":416,"markets":18,"order":66},"Resolve Card BIN","\u002Foperations\u002Fverification\u002Fresolve-card-bin","operations\u002F6.verification\u002Fresolve-card-bin",{"title":418,"path":419,"stem":420,"markets":18,"order":75},"Verify BVN Match","\u002Foperations\u002Fverification\u002Fverify-bvn-match","operations\u002F6.verification\u002Fverify-bvn-match",{"title":152,"markets":18,"order":422,"path":423,"stem":424,"children":425,"page":19},8,"\u002Foperations\u002Fconcepts","operations\u002F8.concepts",[426,430,434,438],{"title":427,"path":428,"stem":429,"markets":18,"order":75},"Customer Lifecycle in Paystack","\u002Foperations\u002Fconcepts\u002Fcustomer-lifecycle","operations\u002F8.concepts\u002Fcustomer-lifecycle",{"title":431,"path":432,"stem":433,"markets":18,"order":66},"The Dispute Resolution Process","\u002Foperations\u002Fconcepts\u002Fdispute-resolution","operations\u002F8.concepts\u002Fdispute-resolution",{"title":435,"path":436,"stem":437,"markets":18,"order":63},"How Settlements Work","\u002Foperations\u002Fconcepts\u002Fhow-settlements-work","operations\u002F8.concepts\u002Fhow-settlements-work",{"title":439,"path":440,"stem":441,"markets":18,"order":84},"Refund Timelines by Channel","\u002Foperations\u002Fconcepts\u002Frefund-timelines","operations\u002F8.concepts\u002Frefund-timelines",{"title":10,"path":443,"stem":444,"children":445},"\u002Fpayments","payments",[446,448,486,538,576,607,625],{"title":10,"path":443,"stem":447,"markets":18,"order":55},"payments\u002Findex",{"title":283,"markets":18,"order":66,"path":449,"stem":450,"children":451},"\u002Fpayments\u002Fchannels","payments\u002F2.channels\u002Findex",[452,454,457,461,464,479,482],{"title":453,"path":449,"stem":450,"markets":18,"order":55},"Payment Channels",{"title":290,"path":455,"stem":456,"markets":18,"order":293},"\u002Fpayments\u002Fchannels\u002Fapple-pay","payments\u002F2.channels\u002Fapple-pay",{"title":458,"path":459,"stem":460,"markets":18,"order":75},"Bank Accounts","\u002Fpayments\u002Fchannels\u002Fbank","payments\u002F2.channels\u002Fbank",{"title":295,"path":462,"stem":463,"markets":18,"order":63},"\u002Fpayments\u002Fchannels\u002Fcards","payments\u002F2.channels\u002Fcards",{"title":299,"markets":18,"order":84,"path":465,"stem":466,"children":467},"\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts","payments\u002F2.channels\u002Fdedicated-virtual-accounts\u002Findex",[468,470,474],{"title":299,"path":465,"stem":466,"markets":469},[250,251],{"title":305,"path":471,"stem":472,"markets":473},"\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts\u002Fcreate-and-assign-dedicated-virtual-accounts","payments\u002F2.channels\u002Fdedicated-virtual-accounts\u002Fcreate-and-assign-dedicated-virtual-accounts",[250,251],{"title":475,"path":476,"stem":477,"markets":478},"Validate Customer","\u002Fpayments\u002Fchannels\u002Fdedicated-virtual-accounts\u002Fvalidate-customer","payments\u002F2.channels\u002Fdedicated-virtual-accounts\u002Fvalidate-customer",[250],{"title":313,"path":480,"stem":481,"markets":18,"order":66},"\u002Fpayments\u002Fchannels\u002Fpwt","payments\u002F2.channels\u002Fpwt",{"title":483,"path":484,"stem":485,"markets":18,"order":107},"USSD","\u002Fpayments\u002Fchannels\u002Fussd","payments\u002F2.channels\u002Fussd",{"title":487,"markets":18,"order":84,"path":488,"stem":489,"children":490},"Online","\u002Fpayments\u002Fonline","payments\u002F3.online\u002Findex",[491,493,507,526,530,534],{"title":492,"path":488,"stem":489,"markets":18,"order":55},"Online payments",{"title":494,"path":495,"stem":496,"children":497,"markets":18,"order":66},"Checkout","\u002Fpayments\u002Fonline\u002Fcheckout","payments\u002F3.online\u002F1.checkout\u002Findex",[498,499,503],{"title":494,"path":495,"stem":496,"markets":18,"order":55},{"title":500,"path":501,"stem":502,"markets":18},"How to integrate Popup Checkout","\u002Fpayments\u002Fonline\u002Fcheckout\u002Fpopup","payments\u002F3.online\u002F1.checkout\u002Fpopup",{"title":504,"path":505,"stem":506,"markets":18},"How to integrate Redirect Checkout","\u002Fpayments\u002Fonline\u002Fcheckout\u002Fredirect","payments\u002F3.online\u002F1.checkout\u002Fredirect",{"title":508,"markets":18,"order":84,"path":509,"stem":510,"children":511},"Charge API","\u002Fpayments\u002Fonline\u002Fcharge-api","payments\u002F3.online\u002F2.charge-api\u002Findex",[512,513,518,522],{"title":508,"path":509,"stem":510,"markets":18,"order":55},{"title":514,"path":515,"stem":516,"markets":517},"How to charge via bank transfer","\u002Fpayments\u002Fonline\u002Fcharge-api\u002Fbank-transfers","payments\u002F3.online\u002F2.charge-api\u002Fbank-transfers",[250,251],{"title":519,"path":520,"stem":521,"markets":18},"How to charge a card","\u002Fpayments\u002Fonline\u002Fcharge-api\u002Fcards","payments\u002F3.online\u002F2.charge-api\u002Fcards",{"title":523,"path":524,"stem":525,"markets":18},"Charge your first card in 10 minutes","\u002Fpayments\u002Fonline\u002Fcharge-api\u002Fquickstart","payments\u002F3.online\u002F2.charge-api\u002Fquickstart",{"title":527,"path":528,"stem":529,"markets":18},"Metadata reference","\u002Fpayments\u002Fonline\u002Fmetadata","payments\u002F3.online\u002Fmetadata",{"title":531,"path":532,"stem":533,"markets":18,"order":63},"Build your first checkout","\u002Fpayments\u002Fonline\u002Fquickstart","payments\u002F3.online\u002Fquickstart",{"title":535,"path":536,"stem":537,"markets":18},"Verify a payment","\u002Fpayments\u002Fonline\u002Fverify-payments","payments\u002F3.online\u002Fverify-payments",{"title":539,"markets":18,"order":75,"path":540,"stem":541,"children":542},"Recurring","\u002Fpayments\u002Frecurring","payments\u002F4.recurring\u002Findex",[543,545,561,565],{"title":544,"path":540,"stem":541,"markets":18,"order":55},"Recurring payments",{"title":546,"markets":18,"order":63,"path":547,"stem":548,"children":549},"Charge authorization","\u002Fpayments\u002Frecurring\u002Fcharge-authorization","payments\u002F4.recurring\u002F1.charge-authorization\u002Findex",[550,552,557],{"title":551,"path":547,"stem":548,"markets":18,"order":55},"How to set up recurring charges",{"title":553,"path":554,"stem":555,"markets":556,"order":66},"Direct Debit","\u002Fpayments\u002Frecurring\u002Fcharge-authorization\u002Fdirect-debit","payments\u002F4.recurring\u002F1.charge-authorization\u002Fdirect-debit",[250],{"title":558,"path":559,"stem":560,"markets":18,"order":63},"How to use partial debits","\u002Fpayments\u002Frecurring\u002Fcharge-authorization\u002Fpartial-debits","payments\u002F4.recurring\u002F1.charge-authorization\u002Fpartial-debits",{"title":562,"path":563,"stem":564,"markets":18,"order":66},"How to run bulk charges","\u002Fpayments\u002Frecurring\u002Fbulk-charge","payments\u002F4.recurring\u002F2.bulk-charge",{"title":566,"path":567,"stem":568,"children":569,"markets":18,"order":84},"Subscriptions","\u002Fpayments\u002Frecurring\u002Fsubscriptions","payments\u002F4.recurring\u002F3.subscriptions\u002Findex",[570,572],{"title":571,"path":567,"stem":568,"markets":18},"How subscriptions work",{"title":573,"path":574,"stem":575,"markets":18},"Set up your first subscription in 15 minutes","\u002Fpayments\u002Frecurring\u002Fsubscriptions\u002Fquickstart","payments\u002F4.recurring\u002F3.subscriptions\u002Fquickstart",{"title":317,"markets":18,"order":107,"path":577,"stem":578,"children":579},"\u002Fpayments\u002Fin-person","payments\u002F5.in-person\u002Findex",[580,582,604],{"title":581,"path":577,"stem":578,"markets":18,"order":55},"In-person payments",{"title":583,"markets":18,"order":63,"path":584,"stem":585,"children":586},"Physical Terminal","\u002Fpayments\u002Fin-person\u002Fphysical-terminal","payments\u002F5.in-person\u002F1.physical-terminal\u002Findex",[587,588,592,596,600],{"title":583,"path":584,"stem":585,"markets":18,"order":55},{"title":589,"path":590,"stem":591,"markets":18},"Custom Terminal apps","\u002Fpayments\u002Fin-person\u002Fphysical-terminal\u002Fcustom-apps","payments\u002F5.in-person\u002F1.physical-terminal\u002Fcustom-apps",{"title":593,"path":594,"stem":595,"markets":18,"order":63},"Your First Terminal Integration","\u002Fpayments\u002Fin-person\u002Fphysical-terminal\u002Fget-started","payments\u002F5.in-person\u002F1.physical-terminal\u002Fget-started",{"title":597,"path":598,"stem":599,"markets":18},"Invoice payments on Terminal","\u002Fpayments\u002Fin-person\u002Fphysical-terminal\u002Finvoice-payments","payments\u002F5.in-person\u002F1.physical-terminal\u002Finvoice-payments",{"title":601,"path":602,"stem":603,"markets":18},"Push payment requests","\u002Fpayments\u002Fin-person\u002Fphysical-terminal\u002Fpush-payment-requests","payments\u002F5.in-person\u002F1.physical-terminal\u002Fpush-payment-requests",{"title":323,"path":605,"stem":606,"markets":18,"order":66},"\u002Fpayments\u002Fin-person\u002Fvirtual-terminal","payments\u002F5.in-person\u002Fvirtual-terminal",{"title":608,"markets":18,"order":134,"path":609,"stem":610,"children":611},"Split payments","\u002Fpayments\u002Fsplit-payments","payments\u002F6.split-payments\u002Findex",[612,613,617,621],{"title":608,"path":609,"stem":610,"markets":18,"order":55},{"title":614,"path":615,"stem":616,"markets":18,"order":63},"Create a subaccount","\u002Fpayments\u002Fsplit-payments\u002Fsubaccounts","payments\u002F6.split-payments\u002F1.subaccounts",{"title":618,"path":619,"stem":620,"markets":18,"order":66},"Split a payment with a subaccount","\u002Fpayments\u002Fsplit-payments\u002Fsingle-split","payments\u002F6.split-payments\u002F2.single-split",{"title":622,"path":623,"stem":624,"markets":18,"order":84},"Split a payment across multiple subaccounts","\u002Fpayments\u002Fsplit-payments\u002Fmulti-split","payments\u002F6.split-payments\u002F3.multi-split",{"title":152,"markets":18,"order":153,"path":626,"stem":627,"children":628,"page":19},"\u002Fpayments\u002Fconcepts","payments\u002F7.concepts",[629,633,637],{"title":630,"path":631,"stem":632,"markets":18,"order":63},"Payment flow","\u002Fpayments\u002Fconcepts\u002Fpayment-flow","payments\u002F7.concepts\u002Fpayment-flow",{"title":634,"path":635,"stem":636,"markets":18,"order":84},"Transaction statuses","\u002Fpayments\u002Fconcepts\u002Ftransaction-statuses","payments\u002F7.concepts\u002Ftransaction-statuses",{"title":638,"path":639,"stem":640,"markets":18,"order":66},"Webhooks vs polling","\u002Fpayments\u002Fconcepts\u002Fwebhooks-vs-polling","payments\u002F7.concepts\u002Fwebhooks-vs-polling",{"title":642,"path":643,"stem":644,"children":645},"Use Cases","\u002Fuse-cases","use-cases",[646,649,670,687,704,721],{"title":647,"path":643,"stem":648,"markets":18,"order":55},"Use-cases","use-cases\u002Findex",{"title":650,"markets":18,"order":63,"path":651,"stem":652,"children":653,"page":19},"Fintech","\u002Fuse-cases\u002Ffintech","use-cases\u002F1.fintech",[654,658,662,666],{"title":655,"path":656,"stem":657,"markets":18},"Fund a Wallet with Paystack","\u002Fuse-cases\u002Ffintech\u002Fwallet-funding","use-cases\u002F1.fintech\u002F1.wallet-funding",{"title":659,"path":660,"stem":661,"markets":18},"Send Money Between Users","\u002Fuse-cases\u002Ffintech\u002Fpeer-to-peer-transfers","use-cases\u002F1.fintech\u002F2.peer-to-peer-transfers",{"title":663,"path":664,"stem":665,"markets":18},"Set Up Recurring Savings Contributions","\u002Fuse-cases\u002Ffintech\u002Fsavings-investment-apps","use-cases\u002F1.fintech\u002F3.savings-investment-apps",{"title":667,"path":668,"stem":669,"markets":18},"Automate Loan Repayment Collection","\u002Fuse-cases\u002Ffintech\u002Flending-loan-repayments","use-cases\u002F1.fintech\u002F4.lending-loan-repayments",{"title":671,"markets":18,"order":66,"path":672,"stem":673,"children":674,"page":19},"E-commerce","\u002Fuse-cases\u002Fecommerce","use-cases\u002F2.ecommerce",[675,679,683],{"title":676,"path":677,"stem":678,"markets":18},"Split Payments Between a Platform and Vendors","\u002Fuse-cases\u002Fecommerce\u002Fmarketplace-split-payments","use-cases\u002F2.ecommerce\u002F1.marketplace-split-payments",{"title":680,"path":681,"stem":682,"markets":18},"Charge Customers on a Monthly Subscription","\u002Fuse-cases\u002Fecommerce\u002Fsubscription-box-store","use-cases\u002F2.ecommerce\u002F2.subscription-box-store",{"title":684,"path":685,"stem":686,"markets":18},"Sell and Deliver Digital Products","\u002Fuse-cases\u002Fecommerce\u002Fdigital-downloads","use-cases\u002F2.ecommerce\u002F3.digital-downloads",{"title":688,"markets":18,"order":84,"path":689,"stem":690,"children":691,"page":19},"Gaming & entertainment","\u002Fuse-cases\u002Fgaming","use-cases\u002F3.gaming",[692,696,700],{"title":693,"path":694,"stem":695,"markets":18},"Accept In-app Purchases on Mobile","\u002Fuse-cases\u002Fgaming\u002Fin-app-purchases","use-cases\u002F3.gaming\u002F1.in-app-purchases",{"title":697,"path":698,"stem":699,"markets":18},"Offer Premium Membership Tiers","\u002Fuse-cases\u002Fgaming\u002Fsubscription-memberships","use-cases\u002F3.gaming\u002F2.subscription-memberships",{"title":701,"path":702,"stem":703,"markets":18},"Sell Virtual Currency (Coins\u002FGems)","\u002Fuse-cases\u002Fgaming\u002Fvirtual-currency-top-ups","use-cases\u002F3.gaming\u002F3.virtual-currency-top-ups",{"title":705,"markets":18,"order":75,"path":706,"stem":707,"children":708,"page":19},"Transportation","\u002Fuse-cases\u002Ftransportation","use-cases\u002F4.transportation",[709,713,717],{"title":710,"path":711,"stem":712,"markets":18},"Capture and Charge Rides with Preauthorization","\u002Fuse-cases\u002Ftransportation\u002Fride-hailing-payment-flow","use-cases\u002F4.transportation\u002F1.ride-hailing-payment-flow",{"title":714,"path":715,"stem":716,"markets":18},"Pay Drivers in Bulk After Each Shift","\u002Fuse-cases\u002Ftransportation\u002Ffleet-driver-payouts","use-cases\u002F4.transportation\u002F2.fleet-driver-payouts",{"title":718,"path":719,"stem":720,"markets":18},"Accept Toll and Ticket Payments Online","\u002Fuse-cases\u002Ftransportation\u002Ftoll-ticketing","use-cases\u002F4.transportation\u002F3.toll-ticketing",{"title":722,"markets":18,"order":107,"path":723,"stem":724,"children":725,"page":19},"Travel & hospitality","\u002Fuse-cases\u002Ftravel","use-cases\u002F5.travel",[726,730,734],{"title":727,"path":728,"stem":729,"markets":18},"Hold a Deposit on Hotel Booking","\u002Fuse-cases\u002Ftravel\u002Fhotel-booking-preauthorization","use-cases\u002F5.travel\u002F1.hotel-booking-preauthorization",{"title":731,"path":732,"stem":733,"markets":18},"Sell Flight Tickets and Process Refunds","\u002Fuse-cases\u002Ftravel\u002Fflight-ticketing-refunds","use-cases\u002F5.travel\u002F2.flight-ticketing-refunds",{"title":735,"path":736,"stem":737,"markets":18},"Sell Tour Experiences with Split Revenue","\u002Fuse-cases\u002Ftravel\u002Ftour-experience-bookings","use-cases\u002F5.travel\u002F3.tour-experience-bookings",{"title":739,"path":740,"stem":252,"children":741,"page":19},"Za","\u002Fza",[742],{"title":10,"path":743,"stem":744,"children":745,"markets":18,"order":55},"\u002Fza\u002Fpayments","za\u002Fpayments\u002Findex",[746,747,779],{"title":10,"path":743,"stem":744,"markets":18,"order":55},{"title":283,"markets":18,"order":66,"path":748,"stem":749,"children":750},"\u002Fza\u002Fpayments\u002Fchannels","za\u002Fpayments\u002Fchannels\u002Findex",[751,752,755,759,763,766,771,775],{"title":288,"path":748,"stem":749,"markets":18,"order":55},{"title":290,"path":753,"stem":754,"markets":18,"order":293},"\u002Fza\u002Fpayments\u002Fchannels\u002Fapple-pay","za\u002Fpayments\u002Fchannels\u002Fapple-pay",{"title":756,"path":757,"stem":758,"markets":18,"order":84},"Capitec Pay","\u002Fza\u002Fpayments\u002Fchannels\u002Fcapitec-pay","za\u002Fpayments\u002Fchannels\u002Fcapitec-pay",{"title":760,"path":761,"stem":762,"markets":18,"order":107},"Card Preauthorization","\u002Fza\u002Fpayments\u002Fchannels\u002Fcard-preauthorization","za\u002Fpayments\u002Fchannels\u002Fcard-preauthorization",{"title":295,"path":764,"stem":765,"markets":18,"order":63},"\u002Fza\u002Fpayments\u002Fchannels\u002Fcards","za\u002Fpayments\u002Fchannels\u002Fcards",{"title":767,"path":768,"stem":769,"markets":18,"order":770},"Google Pay","\u002Fza\u002Fpayments\u002Fchannels\u002Fgoogle-pay","za\u002Fpayments\u002Fchannels\u002Fgoogle-pay",99,{"title":772,"path":773,"stem":774,"markets":18,"order":66},"Instant EFT","\u002Fza\u002Fpayments\u002Fchannels\u002Finstant-eft","za\u002Fpayments\u002Fchannels\u002Finstant-eft",{"title":776,"path":777,"stem":778,"markets":18,"order":75},"QR code payments","\u002Fza\u002Fpayments\u002Fchannels\u002Fqr-codes","za\u002Fpayments\u002Fchannels\u002Fqr-codes",{"title":317,"path":780,"stem":781,"children":782,"markets":18,"order":107},"\u002Fza\u002Fpayments\u002Fin-person","za\u002Fpayments\u002Fin-person\u002Findex",[783,784],{"title":288,"path":780,"stem":781,"markets":18,"order":55},{"title":323,"path":785,"stem":786,"markets":18,"order":63},"\u002Fza\u002Fpayments\u002Fin-person\u002Fvirtual-terminal","za\u002Fpayments\u002Fin-person\u002Fvirtual-terminal",{"id":788,"title":254,"body":789,"description":1366,"extension":1367,"markets":18,"meta":1368,"navigation":18,"path":255,"seo":1369,"stem":256,"type":1370,"whats_next":18,"__hash__":1371},"content\u002Fdisbursements\u002Ftransfers\u002F03.single-transfers.md",{"type":790,"value":791,"toc":1356},"minimark",[792,796,825,841,845,852,860,863,866,880,915,1042,1045,1064,1069,1073,1076,1093,1096,1099,1102,1107,1122,1128,1178,1182,1186,1194,1197,1222,1226,1229,1249,1252,1255,1323,1326,1352],[793,794,795],"p",{},"You can transfer money in four easy steps:",[797,798,799,807,813,819],"ul",{},[800,801,802],"li",{},[803,804,806],"a",{"href":805},"#create-a-transfer-recipient","Create a transfer recipient",[800,808,809],{},[803,810,812],{"href":811},"#generate-a-transfer-reference","Generate a transfer reference",[800,814,815],{},[803,816,818],{"href":817},"#initiate-a-transfer","Initiate a transfer",[800,820,821],{},[803,822,824],{"href":823},"#verify-a-transfer","Verify a transfer",[826,827,830],"callout",{"title":828,"type":829},"Before you begin!","info",[793,831,832,833,840],{},"To send money on Paystack, you need API keys to authenticate your transfers. You can find your keys on the Paystack Dashboard under ",[803,834,839],{"href":835,"rel":836,"target":838},"https:\u002F\u002Fdashboard.paystack.com\u002Fv2\u002Fdevelopers\u002Fapi-configuration",[837],"nofollow","_blank","Developers → API configuration",".",[842,843,806],"h2",{"id":844},"create-a-transfer-recipient",[793,846,847,848,851],{},"A transfer recipient is a beneficiary on your integration that you can send money to. Before sending money to your customer, you need to collect their details first, then use their details to ",[803,849,850],{"href":243},"create a transfer recipient",". The Recipients page lists the recipient types available in your market.",[793,853,854,855,859],{},"The ",[856,857,858],"code",{},"recipient_code"," from the data object is the unique identifier for a user and would be used to make transfers to that customer This code should be saved with the customer's records in your database.",[842,861,812],{"id":862},"generate-a-transfer-reference",[793,864,865],{},"A transfer reference is a unique identifier that lets you track, manage and reconcile each transfer request made on your integration. Transfer references allow you to prevent double crediting as you can retry a non-conclusive transfer rather than initiate a new request.",[793,867,868,869,874,875,879],{},"In order to take advantage of a transfer reference, you need to generate and provide it for every request. We recommend ",[803,870,873],{"href":871,"rel":872,"target":838},"https:\u002F\u002Fwww.uuidgenerator.net\u002Fversion4",[837],"generating a v4 UUID"," reference of no more than ",[876,877,878],"strong",{},"50 characters",". However, here are the constraints to take note of regardless of the logic you decide to implement:",[881,882,883,901,907,912],"ol",{},[800,884,885,886,889,890,893,894,897,898,900],{},"The reference can only contain lowercase letters (",[856,887,888],{},"a-z","), digits (",[856,891,892],{},"0-9",") and these symbols: underscore (",[856,895,896],{},"_",") and dash (",[856,899,896],{},")",[800,902,903,904],{},"The minimum length should be ",[876,905,906],{},"16 characters",[800,908,909,910],{},"The maximum length should be ",[876,911,878],{},[800,913,914],{},"You can prepend or append special identifiers to the reference to further reduce the chances of collision",[916,917,922],"pre",{"className":918,"code":919,"language":920,"meta":921,"style":921},"language-json shiki shiki-themes material-theme-lighter github-light github-dark-dimmed","{\n  \"source\": \"balance\",\n  \"reason\": \"Bonus for the week\",\n  \"amount\": 100000,\n  \"recipient\": \"RCP_gd9vgag7n5lr5ix\",\n  \"reference\": \"acv_9ee55786-2323-4760-98e2-6380c9cb3f68\"\n}\n","json","",[856,923,924,932,961,981,998,1018,1037],{"__ignoreMap":921},[925,926,928],"span",{"class":927,"line":63},"line",[925,929,931],{"class":930},"s7Vxm","{\n",[925,933,934,938,942,945,948,952,956,958],{"class":927,"line":66},[925,935,937],{"class":936},"sLsO-","  \"",[925,939,941],{"class":940},"sO5ea","source",[925,943,944],{"class":936},"\"",[925,946,947],{"class":930},":",[925,949,951],{"class":950},"sO3A-"," \"",[925,953,955],{"class":954},"sOv1k","balance",[925,957,944],{"class":950},[925,959,960],{"class":930},",\n",[925,962,963,965,968,970,972,974,977,979],{"class":927,"line":84},[925,964,937],{"class":936},[925,966,967],{"class":940},"reason",[925,969,944],{"class":936},[925,971,947],{"class":930},[925,973,951],{"class":950},[925,975,976],{"class":954},"Bonus for the week",[925,978,944],{"class":950},[925,980,960],{"class":930},[925,982,983,985,988,990,992,996],{"class":927,"line":75},[925,984,937],{"class":936},[925,986,987],{"class":940},"amount",[925,989,944],{"class":936},[925,991,947],{"class":930},[925,993,995],{"class":994},"sCI7e"," 100000",[925,997,960],{"class":930},[925,999,1000,1002,1005,1007,1009,1011,1014,1016],{"class":927,"line":107},[925,1001,937],{"class":936},[925,1003,1004],{"class":940},"recipient",[925,1006,944],{"class":936},[925,1008,947],{"class":930},[925,1010,951],{"class":950},[925,1012,1013],{"class":954},"RCP_gd9vgag7n5lr5ix",[925,1015,944],{"class":950},[925,1017,960],{"class":930},[925,1019,1020,1022,1025,1027,1029,1031,1034],{"class":927,"line":134},[925,1021,937],{"class":936},[925,1023,1024],{"class":940},"reference",[925,1026,944],{"class":936},[925,1028,947],{"class":930},[925,1030,951],{"class":950},[925,1032,1033],{"class":954},"acv_9ee55786-2323-4760-98e2-6380c9cb3f68",[925,1035,1036],{"class":950},"\"\n",[925,1038,1039],{"class":927,"line":153},[925,1040,1041],{"class":930},"}\n",[842,1043,818],{"id":1044},"initiate-a-transfer",[793,1046,1047,1048,1051,1052,1057,1058,1060,1061,1063],{},"To send money to a customer, you make a ",[856,1049,1050],{},"POST"," request to the ",[1053,1054],"api-link",{"path":1055,"title":1056},"\u002Ftransfer#initiate","Initiate Transfer"," endpoint, passing the ",[856,1059,1024],{}," and ",[856,1062,858],{}," previously created.",[793,1065,1066,1067,840],{},"If OTP is turned on for transfers, the transfer waits for approval. To approve it or turn OTP off for automated transfers, see ",[803,1068,266],{"href":267},[1070,1071],"localized-request-response",{"src":1072},"disbursements\u002Ftransfers\u002Finitiate",[793,1074,1075],{},"When you send this request, if there are no errors, the response comes back with a pending status, while the transfer is being processed.",[826,1077,1080],{"title":1078,"type":1079},"Retrying a transfer","warning",[793,1081,1082,1083,1089,1090,1092],{},"If there is an error with the transfer request, ",[876,1084,1085,1086,1088],{},"you should retry the transaction with the same ",[856,1087,1024],{}," to avoid double crediting",". If a new ",[856,1091,1024],{}," is used, the transfer would be treated as a new request.",[793,1094,1095],{},"Test transfers always return success, because there is no processing involved. The live transfers processing usually take between a few seconds and a few minutes. When it's done processing, a notification is sent to your webhook URL.",[842,1097,824],{"id":1098},"verify-a-transfer",[793,1100,1101],{},"When a transfer is initiated, it could take a few seconds or minutes to be processed. This is why we recommend relying on webhooks for verification as opposed to polling.",[1103,1104,1106],"h3",{"id":1105},"verify-via-webhooks","Verify via webhooks",[826,1108,1110],{"title":1109,"type":829},"Receiving Notifications",[793,1111,1112,1113,1117,1118,1121],{},"In order to receive notifications, you need to ",[803,1114,1116],{"href":1115},"\u002Fdeveloper-tools\u002Fintegration\u002Fwebhooks#how-to-set-up-and-verify-webhooks","implement a webhook URL"," and set the webhook URL in ",[803,1119,839],{"href":835,"rel":1120,"target":838},[837]," on your Paystack Dashboard.",[793,1123,1124,1125,1127],{},"Once a transfer is processed, we send the final status of the transfer as a ",[856,1126,1050],{}," request to your webhook URL.",[1129,1130,1131,1144],"table",{},[1132,1133,1134],"thead",{},[1135,1136,1137,1141],"tr",{},[1138,1139,1140],"th",{},"Event",[1138,1142,1143],{},"Description",[1145,1146,1147,1158,1168],"tbody",{},[1135,1148,1149,1155],{},[1150,1151,1152],"td",{},[856,1153,1154],{},"transfer.success",[1150,1156,1157],{},"This is sent when the transfer is successful",[1135,1159,1160,1165],{},[1150,1161,1162],{},[856,1163,1164],{},"transfer.failed",[1150,1166,1167],{},"This is sent when the transfer fails",[1135,1169,1170,1175],{},[1150,1171,1172],{},[856,1173,1174],{},"transfer.reversed",[1150,1176,1177],{},"This is sent when we refund a previously debited amount for a transfer that couldn’t be completed",[1179,1180],"localized-snippet",{"src":1181},"disbursements\u002Ftransfers\u002Ftransfer-events",[1103,1183,1185],{"id":1184},"verify-via-polling","Verify via polling",[793,1187,1188,1189,1193],{},"If you prefer to use an endpoint to verify the status of the transfer, you can call the ",[803,1190,1192],{"href":1191},"\u002Fapi\u002Ftransfer#verify","Verify Transfer"," endpoint with the transfer reference you used for the request:",[1070,1195],{"src":1196},"disbursements\u002Ftransfers\u002Fverify",[826,1198,1200],{"title":1199,"type":1079},"Verification status",[793,1201,1202,1203,1206,1207,1210,1211,1213,1214,1217,1218,1221],{},"The HTTP status code you get from the API response indicates the status of the API call and not the status of the transfer. The status of the transfer is in the ",[856,1204,1205],{},"data"," object of the response, i.e ",[856,1208,1209],{},"data.status",". The status of a transfer should only be updated with the ",[856,1212,1209],{}," value when you get a ",[876,1215,1216],{},"200 status code",". Check out the ",[803,1219,1220],{"href":271},"how transfers work page"," to learn more about handling transfer statuses.",[842,1223,1225],{"id":1224},"troubleshooting","Troubleshooting",[793,1227,1228],{},"When building or maintaining your transfer integration, keep the following integration checklist in mind:",[797,1230,1231,1234,1237,1240,1243,1246],{},[800,1232,1233],{},"Ensure you have enough funds in your Paystack balance to carry out your transfers",[800,1235,1236],{},"Ensure you are sending amount in the smallest denomination of your currency",[800,1238,1239],{},"Ensure you have generated a transfer reference",[800,1241,1242],{},"Implement a webhook URL to receive updates",[800,1244,1245],{},"Ensure the recipient details are valid",[800,1247,1248],{},"Ensure there are no long running tasks in your approval URL",[793,1250,1251],{},"Despite checking all items in the checklist, things might still not work as they should. If you encounter any issue with your integration, the first step is to check the status of the transfer.",[793,1253,1254],{},"Typically, issues occur during the validation phase or when there are multiple occurrences of an unsuccessful status. Validation errors come with descriptive messages and solutions are easy to fix. Here are some errors and solutions to them:",[1129,1256,1257,1267],{},[1132,1258,1259],{},[1135,1260,1261,1264],{},[1138,1262,1263],{},"Error",[1138,1265,1266],{},"Resolution",[1145,1268,1269,1283,1294,1302,1310],{},[1135,1270,1271,1274],{},[1150,1272,1273],{},"Your reference contains illegal special characters",[1150,1275,1276,1277,1280,1281,900],{},"Ensure that the reference contains lowercase alphanumeric characters and the only special characters are hyphen (",[856,1278,1279],{},"-",") and underscore (",[856,1282,896],{},[1135,1284,1285,1288],{},[1150,1286,1287],{},"Your balance is not enough to fulfil this request",[1150,1289,1290,1293],{},[803,1291,1292],{"href":263},"Top up your Paystack balance"," and try again",[1135,1295,1296,1299],{},[1150,1297,1298],{},"Sorry, we can't make the transfer to this recipient at the moment",[1150,1300,1301],{},"The customer should reach out to the bank to resolve the issues with their account",[1135,1303,1304,1307],{},[1150,1305,1306],{},"Account closed",[1150,1308,1309],{},"The customer should reach out to the bank if they didn't close the account",[1135,1311,1312,1315],{},[1150,1313,1314],{},"Bank code is invalid",[1150,1316,1317,1318,1322],{},"Ensure that you're passing the correct bank code. Use the ",[803,1319,1321],{"href":1320},"\u002Fapi\u002Fbank#list","list bank"," endpoint to get the list of all available banks and their corresponding bank codes",[793,1324,1325],{},"A transfer request could also be stuck in an unsuccessful status. Here's how to handle unsuccessful status:",[881,1327,1328,1340,1346],{},[800,1329,1330,1333,1334,1339],{},[856,1331,1332],{},"pending",": A transfer might remain in this state for a long time if there is an issue communicating with the recipient's bank. This is one of the reasons why we use queues. We keep retrying through different channels till we've exhausted all options and the transfer fails. You can also ",[803,1335,1338],{"href":1336,"rel":1337},"https:\u002F\u002Fstatus.paystack.com\u002F",[837],"check our status page"," to confirm that there's no incident.",[800,1341,1342,1345],{},[856,1343,1344],{},"blocked",": This happens when your server fails to respond to approval request within a few seconds. If multiple transfers keep returning this status, check your approval logic to ensure that there are no long running tasks.",[800,1347,1348,1351],{},[856,1349,1350],{},"abandoned",": A high rate of abandoned transfers means there's an OTP issue. OTP is either not being delivered or you aren't using the OTP within 30 minutes. If you are going to use OTP for approval, we recommend turning on both email and phone channels. This is to increase the chances of OTP delivery.",[1353,1354,1355],"style",{},"html pre.shiki code .s7Vxm, html code.shiki .s7Vxm{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#ADBAC7}html pre.shiki code .sLsO-, html code.shiki .sLsO-{--shiki-light:#39ADB5;--shiki-default:#005CC5;--shiki-dark:#8DDB8C}html pre.shiki code .sO5ea, html code.shiki .sO5ea{--shiki-light:#9C3EDA;--shiki-default:#005CC5;--shiki-dark:#8DDB8C}html pre.shiki code .sO3A-, html code.shiki .sO3A-{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#96D0FF}html pre.shiki code .sOv1k, html code.shiki .sOv1k{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#96D0FF}html pre.shiki code .sCI7e, html code.shiki .sCI7e{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#6CB6FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":921,"searchDepth":66,"depth":66,"links":1357},[1358,1359,1360,1361,1365],{"id":844,"depth":66,"text":806},{"id":862,"depth":66,"text":812},{"id":1044,"depth":66,"text":818},{"id":1098,"depth":66,"text":824,"children":1362},[1363,1364],{"id":1105,"depth":84,"text":1106},{"id":1184,"depth":84,"text":1185},{"id":1224,"depth":66,"text":1225},"Create a recipient, initiate one transfer, complete OTP approval when needed, and confirm the final status.","md",{},{"title":254,"description":1366},"how-to","7LRX_BXIxiYoG_LdrRoYPUQOU0Rtd6wtGFwRfrCUx4w",1794998080230]