Transfer identifier from the initiate transfer request (transfer_id you supplied while initiating the transfer). Only alphanumeric characters, periods (.), hyphens (-), and underscores (_) are allowed.
Optional key-value pairs for any extra information. Keys and values must be strings. The following constraints apply:
Maximum 10 entries.
Keys: maximum 50 characters. Alphanumeric characters, underscores (_), periods (.), commas (,), single quotes ('), ampersands (&), hyphens (-), and spaces are allowed.
Values: maximum 200 characters. Same character set as keys.
Timestamp when the transfer transaction was processed. Will be null if still pending.
Example:
"2025-09-02T10:17:45Z"
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cashfree Developer Documentation","colors":{"primary":"#6930ca","light":"#cfb8f5","dark":"#130851"},"logo":{"light":"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/light.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=8a2837083063d8a01e0be6b454a1baf1","dark":"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/dark.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=5c7de40784c6f6f9eebdad085ec5a7ef"},"favicon":"https://mintcdn.com/cashfreepayments-d00050e9/NpjCgm3mwC7v6gp-/static/favicon.png?fit=max\u0026auto=format\u0026n=NpjCgm3mwC7v6gp-\u0026q=85\u0026s=ba85dcd024bd70845e38c3f3957514c6","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#fbfbfb","dark":"#000000"}},"navbar":{"links":[{"href":"https://www.cashfree.com/support/","label":"Contact Us"}],"primary":{"type":"button","label":"Get Started","href":"https://merchant.cashfree.com/merchants/signup?source-action=docs%20page\u0026action=Sign%20Up\u0026button-id=StartNow_Navbar"}},"footer":{"socials":{"github":"https://github.com/cashfree","youtube":"https://www.youtube.com/channel/UCxO0W7xVngh7TfkChPa_nwg","website":"https://www.cashfree.com/blog/category/engineering","discord":"https://discord.com/invite/w97HT9RKCF"}},"search":{"prompt":"Search or ask..."},"seo":{"metatags":{"og:title":"Cashfree Developer Documentation","og:description":"Welcome to the Cashfree developer documentation. You will find help about Cashfree products and APIs that will help you start using our products quickly.","og:site_name":"Cashfree Developer Documentation","twitter:site":"@gocashfree","google-site-verification":"T69Ao_T0Ps8pkRbluKzW179qvd_aCsWISCApeSsIhRU"},"indexing":"all"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"codeblocks":"dark","latex":true},"integrations":{"ga4":{"measurementId":"G-56SCQ867FW"},"gtm":{"tagId":"GTM-5SRVH4P"}},"contextual":{"options":["chatgpt","claude","copy","view",{"title":"Open in Discord","description":"Join our Discord community","icon":"discord","href":"https://discord.com/invite/w97HT9RKCF"}],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cashfreepayments-d00050e9","hasAudioNarration":false,"actualSubdomain":"cashfreepayments-d00050e9","customDomains":["www.cashfree.com"],"gitSource":{"type":"github","owner":"cashfree","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae49f2dbfaae13da36b452f","collectionId":"849e9bcc-f7f0-46ac-84be-219ff7da0505","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae49f2dbfaae13da36b452f"},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae49f2dbfaae13da36b452f","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Payments APIs","count":520},{"language":"default","tag":"Other Versions","count":349},{"language":"default","tag":"Payments","count":305},{"language":"default","tag":"v2026-01-01","count":159},{"language":"default","tag":"Subscription","count":151},{"language":"default","tag":"v2025-01-01","count":150},{"language":"default","tag":"v2023-08-01","count":142},{"language":"default","tag":"Payment Gateway","count":136},{"language":"default","tag":"Secure ID","count":106},{"language":"default","tag":"Payouts","count":105}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":false,"email":"documentation@cashfree.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"starterQuestions":[{"_id":"6916d346c181a220cfa37e8d","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I accept payments online?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:59:18.295Z","updatedAt":"2025-11-14T06:59:18.295Z","__v":0},{"_id":"6916d306c181a220cfa370e8","deploymentId":"66d5827f2de686bc28e7722b","questionText":"What is Cashfree Hosted Checkout?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:58:14.574Z","updatedAt":"2025-11-14T06:58:14.574Z","__v":0},{"_id":"6916d2dbc181a220cfa368a4","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I create a payment link?","status":"active","generatedBy":"manual","createdAt":"2025-11-14T06:57:31.657Z","updatedAt":"2025-11-14T06:57:31.657Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/cashfreepayments-d00050e9/e1e3b3ccb8bef592/style.css"},{"filePath":"grid.css","content":".container,.container-fluid{margin-right:auto;margin-left:auto}.container{padding-top:3rem;padding-bottom:3rem}.container-fluid{padding:3rem 2rem}.col-xs,.row{box-sizing:border-box}.row{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-right:-.5rem;margin-left:-.5rem}.col.reverse,.row.reverse{-webkit-box-orient:horizontal;-webkit-box-direction:reverse;-ms-flex-direction:row-reverse;flex-direction:row-reverse}.col.reverse{-webkit-box-orient:vertical;-ms-flex-direction:column-reverse;flex-direction:column-reverse}.col-xs{-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-xs-1,.col-xs-10,.col-xs-11,.col-xs-12,.col-xs-2,.col-xs-3,.col-xs-4,.col-xs-5,.col-xs-6,.col-xs-7,.col-xs-8,.col-xs-9,.col-xs-offset-0,.col-xs-offset-1,.col-xs-offset-10,.col-xs-offset-11,.col-xs-offset-12,.col-xs-offset-2,.col-xs-offset-3,.col-xs-offset-4,.col-xs-offset-5,.col-xs-offset-6,.col-xs-offset-7,.col-xs-offset-8,.col-xs-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-xs{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-xs-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-xs-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-xs-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-xs-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-xs-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-xs-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-xs-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-xs-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-xs-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-xs-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-xs-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-xs-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-xs-offset-0{margin-left:0}.col-xs-offset-1{margin-left:8.33333333%}.col-xs-offset-2{margin-left:16.66666667%}.col-xs-offset-3{margin-left:25%}.col-xs-offset-4{margin-left:33.33333333%}.col-xs-offset-5{margin-left:41.66666667%}.col-xs-offset-6{margin-left:50%}.col-xs-offset-7{margin-left:58.33333333%}.col-xs-offset-8{margin-left:66.66666667%}.col-xs-offset-9{margin-left:75%}.col-xs-offset-10{margin-left:83.33333333%}.col-xs-offset-11{margin-left:91.66666667%}.start-xs{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-xs{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-xs{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-xs{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-xs{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-xs{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-xs{-ms-flex-pack:distribute;justify-content:space-around}.between-xs{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-xs{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-xs{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}@media only screen and (min-width:48em){.container{width:49rem}.col-sm{box-sizing:border-box;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-offset-0,.col-sm-offset-1,.col-sm-offset-10,.col-sm-offset-11,.col-sm-offset-12,.col-sm-offset-2,.col-sm-offset-3,.col-sm-offset-4,.col-sm-offset-5,.col-sm-offset-6,.col-sm-offset-7,.col-sm-offset-8,.col-sm-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-sm{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-sm-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-sm-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-sm-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-sm-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-sm-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-sm-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-sm-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-sm-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-sm-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-sm-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-sm-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-sm-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-sm-offset-0{margin-left:0}.col-sm-offset-1{margin-left:8.33333333%}.col-sm-offset-2{margin-left:16.66666667%}.col-sm-offset-3{margin-left:25%}.col-sm-offset-4{margin-left:33.33333333%}.col-sm-offset-5{margin-left:41.66666667%}.col-sm-offset-6{margin-left:50%}.col-sm-offset-7{margin-left:58.33333333%}.col-sm-offset-8{margin-left:66.66666667%}.col-sm-offset-9{margin-left:75%}.col-sm-offset-10{margin-left:83.33333333%}.col-sm-offset-11{margin-left:91.66666667%}.start-sm{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-sm{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-sm{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-sm{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-sm{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-sm{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-sm{-ms-flex-pack:distribute;justify-content:space-around}.between-sm{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-sm{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-sm{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}@media only screen and (min-width:64em){.container{width:65rem}.col-md{box-sizing:border-box;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-offset-0,.col-md-offset-1,.col-md-offset-10,.col-md-offset-11,.col-md-offset-12,.col-md-offset-2,.col-md-offset-3,.col-md-offset-4,.col-md-offset-5,.col-md-offset-6,.col-md-offset-7,.col-md-offset-8,.col-md-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-md{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-md-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-md-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-md-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-md-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-md-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-md-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-md-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-md-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-md-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-md-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-md-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-md-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-md-offset-0{margin-left:0}.col-md-offset-1{margin-left:8.33333333%}.col-md-offset-2{margin-left:16.66666667%}.col-md-offset-3{margin-left:25%}.col-md-offset-4{margin-left:33.33333333%}.col-md-offset-5{margin-left:41.66666667%}.col-md-offset-6{margin-left:50%}.col-md-offset-7{margin-left:58.33333333%}.col-md-offset-8{margin-left:66.66666667%}.col-md-offset-9{margin-left:75%}.col-md-offset-10{margin-left:83.33333333%}.col-md-offset-11{margin-left:91.66666667%}.start-md{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-md{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-md{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-md{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-md{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-md{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-md{-ms-flex-pack:distribute;justify-content:space-around}.between-md{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-md{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-md{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}@media only screen and (min-width:75em){.container{width:76rem}.col-lg{box-sizing:border-box;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-offset-0,.col-lg-offset-1,.col-lg-offset-10,.col-lg-offset-11,.col-lg-offset-12,.col-lg-offset-2,.col-lg-offset-3,.col-lg-offset-4,.col-lg-offset-5,.col-lg-offset-6,.col-lg-offset-7,.col-lg-offset-8,.col-lg-offset-9{box-sizing:border-box;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;padding-right:.5rem;padding-left:.5rem}.col-lg{-webkit-box-flex:1;-ms-flex-positive:1;flex-grow:1;-ms-flex-preferred-size:0;flex-basis:0;max-width:100%}.col-lg-1{-ms-flex-preferred-size:8.33333333%;flex-basis:8.33333333%;max-width:8.33333333%}.col-lg-2{-ms-flex-preferred-size:16.66666667%;flex-basis:16.66666667%;max-width:16.66666667%}.col-lg-3{-ms-flex-preferred-size:25%;flex-basis:25%;max-width:25%}.col-lg-4{-ms-flex-preferred-size:33.33333333%;flex-basis:33.33333333%;max-width:33.33333333%}.col-lg-5{-ms-flex-preferred-size:41.66666667%;flex-basis:41.66666667%;max-width:41.66666667%}.col-lg-6{-ms-flex-preferred-size:50%;flex-basis:50%;max-width:50%}.col-lg-7{-ms-flex-preferred-size:58.33333333%;flex-basis:58.33333333%;max-width:58.33333333%}.col-lg-8{-ms-flex-preferred-size:66.66666667%;flex-basis:66.66666667%;max-width:66.66666667%}.col-lg-9{-ms-flex-preferred-size:75%;flex-basis:75%;max-width:75%}.col-lg-10{-ms-flex-preferred-size:83.33333333%;flex-basis:83.33333333%;max-width:83.33333333%}.col-lg-11{-ms-flex-preferred-size:91.66666667%;flex-basis:91.66666667%;max-width:91.66666667%}.col-lg-12{-ms-flex-preferred-size:100%;flex-basis:100%;max-width:100%}.col-lg-offset-0{margin-left:0}.col-lg-offset-1{margin-left:8.33333333%}.col-lg-offset-2{margin-left:16.66666667%}.col-lg-offset-3{margin-left:25%}.col-lg-offset-4{margin-left:33.33333333%}.col-lg-offset-5{margin-left:41.66666667%}.col-lg-offset-6{margin-left:50%}.col-lg-offset-7{margin-left:58.33333333%}.col-lg-offset-8{margin-left:66.66666667%}.col-lg-offset-9{margin-left:75%}.col-lg-offset-10{margin-left:83.33333333%}.col-lg-offset-11{margin-left:91.66666667%}.start-lg{-webkit-box-pack:start;-ms-flex-pack:start;justify-content:flex-start;text-align:start}.center-lg{-webkit-box-pack:center;-ms-flex-pack:center;justify-content:center;text-align:center}.end-lg{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;text-align:end}.top-lg{-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start}.middle-lg{-webkit-box-align:center;-ms-flex-align:center;align-items:center}.bottom-lg{-webkit-box-align:end;-ms-flex-align:end;align-items:flex-end}.around-lg{-ms-flex-pack:distribute;justify-content:space-around}.between-lg{-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}.first-lg{-webkit-box-ordinal-group:0;-ms-flex-order:-1;order:-1}.last-lg{-webkit-box-ordinal-group:2;-ms-flex-order:1;order:1}}"},{"filePath":"typography.css","content":".landing-page h1{font-size:2.4rem}.landing-page h2{font-size:2rem}.landing-page h3{font-size:1.6rem}.landing-page h4{font-size:1.2rem}.landing-page h5{font-size:1rem}.landing-page h6{font-size:.8rem}.bold{font-weight:700}.semibold{font-weight:600}.medium{font-weight:500}.regular{font-weight:400}.light{font-weight:300}"}],"page":{"pagePath":"api-reference/prepaid-payment-instruments/transfers/verify-transfer","slug":"/api-reference/prepaid-payment-instruments/transfers/verify-transfer","pageMetadata":{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/transfer/verify","keywords":["verify transfer","wallet transfers","PPI","API reference","fund transfer"],"og:title":"Verify Transfer API | Cashfree","og:description":"Submit the OTP shared with the Cashfree PPI wallet user to authorise an initiated transfer so the partner bank can complete the payout to the beneficiary.","title":"Verify Transfer","description":"Submits the OTP for a wallet transfer that was initiated with mode `OTP_VERIFICATION`. \nUse **Get Transfer Details** or webhooks for terminal status.\n","href":"/api-reference/prepaid-payment-instruments/transfers/verify-transfer","hidden":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Submits the OTP for a wallet transfer that was initiated with mode \", _jsx(_components.code, {\n children: \"OTP_VERIFICATION\"\n }), \".\\nUse \", _jsx(_components.strong, {\n children: \"Get Transfer Details\"\n }), \" or webhooks for terminal status.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`Call this API after `,_jsx(_components.a,{href:`/api-reference/prepaid-payment-instruments/transfers/initiate-transfer`,children:`Initiate Transfer`}),`. Use `,_jsx(_components.a,{href:`/api-reference/prepaid-payment-instruments/transfers/get-transfer-details`,children:`Get Transfer Details`}),` to proceed with bank processing after OTP succeeds.`]})}),`\n`,_jsxs(_components.p,{children:[`You can submit an OTP for verification `,_jsx(_components.strong,{children:`at most three times`}),` per transfer.`]})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/transfer/verify","keywords":["verify transfer","wallet transfers","PPI","API reference","fund transfer"],"og:title":"Verify Transfer API | Cashfree","og:description":"Submit the OTP shared with the Cashfree PPI wallet user to authorise an initiated transfer so the partner bank can complete the payout to the beneficiary.","title":"Verify Transfer","description":"Submits the OTP for a wallet transfer that was initiated with mode `OTP_VERIFICATION`. \nUse **Get Transfer Details** or webhooks for terminal status.\n","href":"/api-reference/prepaid-payment-instruments/transfers/verify-transfer","hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/cashfreepayments-d00050e9/0a1efd0b138512b4/util/downloadImages.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/7b49b0aba32ccd66/util/checkLinks.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/6520965c686ab08e/util/updateFrontmatter.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e6313895ea4c2bf0/export-docs/export.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/6459e4b38b43a234/export-docs/sync-kb.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/82d5b75dd1e333d2/snippets/postman-buttons/postman-links.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e8f71dc9fab8d95d/scripts/ga4-video-tracking.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/e3b0c44298fc1c14/scripts/generate-postman-buttons.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/bc4eac15553663a2/scripts/openapi-rm-desc.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/5748000362acad1e/scripts/quote-openapi.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/0a7365ce97b5cca7/scripts/script.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/d99a96c0c4b010fe/scripts/updateHelpAccordionsWithPostHog.js","/docs/_mintlify/custom/cashfreepayments-d00050e9/bd8561d01634fd2e/scripts/updateIframeSrc.js"],"openApiReferenceData":{"operation":{"summary":"Verify Transfer","description":"Submits the OTP for a wallet transfer that was initiated with mode `OTP_VERIFICATION`. \nUse **Get Transfer Details** or webhooks for terminal status.\n","operationId":"verifyWalletTransferOtp","tags":["Transfers"],"parameters":["ed872d6d-386e-427a-a63e-0da873698251"],"security":["5c2d9c0e-3813-4492-9995-1683368012ba"],"requestBody":"b00c0c47-71e4-434c-8b2f-e89ce7c69a96","responses":{"200":"f18b7dc6-0b4a-4a04-ba74-f88f078daed9","400":"533ac638-c878-4140-acf5-3a72f8131f50","401":"527887c1-344c-4d33-b0ae-4665703e0758","403":"e69f9b06-621f-4ca2-ae77-bc710008f860","404":"effb37fc-9740-4e34-98e7-cf44cdbfc3d9","429":"9296afc5-7980-4bce-af4a-5f3cd85eb36d","500":"5c852f26-6198-4ed1-aace-33f7d71ef4d3"},"method":"post","type":"path","servers":["8cee66d8-0b87-41ef-ab76-cce054584ced","f7bb6ace-47fa-4bed-99e0-0765bd0613d1"],"path":"/ppi/wallet/transfer/verify","baseUrlOptions":["https://api.cashfree.com","https://sandbox.cashfree.com"],"title":"Verify Transfer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ed872d6d-386e-427a-a63e-0da873698251":{"description":"API version to be used. Format is in YYYY-MM-DD.","name":"x-api-version","in":"header","required":true,"schema":{"type":"string","default":"2025-11-01","example":"2025-11-01","isRequired":true,"description":"API version to be used. Format is in YYYY-MM-DD.","uniqueKey":"","typeLabel":"string"},"example":"2025-11-01"}},"requestBody":{"description":"Request parameters to verify the OTP for a wallet transfer request.","required":true,"content":{"application/json":{"schema":{"type":"object","required":["transfer_id","otp"],"properties":{"transfer_id":{"type":"string","description":"Transfer identifier from the initiate transfer request (`transfer_id` you supplied while initiating the transfer). Only alphanumeric characters, periods (.), hyphens (-), and underscores (_) are allowed.","example":"TRANSFER123456","minLength":1,"maxLength":50,"isRequired":true,"uniqueKey":"transfer_id","typeLabel":"string"},"otp":{"type":"string","description":"One-time password received by the end user on the configured notification channels. Only numeric characters are allowed.","example":"222113","minLength":4,"maxLength":10,"isRequired":true,"uniqueKey":"otp","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"verifyTransferOtp":{"title":"verifyTransferOtp","value":{"transfer_id":"TRANSFER123456","otp":"222113"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f18b7dc6-0b4a-4a04-ba74-f88f078daed9":{"description":"Success response for verifying a wallet transfer OTP.","content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Unique identifier for the user, as provided by you during PPI user creation.","example":"USER827364","uniqueKey":"user_id","typeLabel":"string"},"wallet_id":{"type":"string","description":"Unique identifier for the wallet, as provided by you during wallet creation.","example":"WALLET936721","uniqueKey":"wallet_id","typeLabel":"string"},"cf_transfer_id":{"type":"string","description":"Unique identifier for the transfer transaction, generated by Cashfree.","example":"8901234567890123456","uniqueKey":"cf_transfer_id","typeLabel":"string"},"transfer_id":{"type":"string","description":"Unique identifier for the transfer transaction, as provided by you during the transfer request.","example":"TRANSFER123456","uniqueKey":"transfer_id","typeLabel":"string"},"amount":{"type":"number","format":"double","description":"Amount that was transferred.","example":1250.5,"uniqueKey":"amount","typeLabel":"number\u003cdouble>"},"transfer_mode":{"type":"string","description":"Mode of transfer used.","enum":["RTGS","NEFT","IMPS","UPI"],"example":"IMPS","uniqueKey":"transfer_mode","typeLabel":"enum\u003cstring>"},"sub_wallet":{"type":"object","properties":{"cf_sub_wallet_id":{"type":"string","description":"Unique identifier for the sub-wallet provided in response while creating the wallet.","example":"5432109876543210987","uniqueKey":"sub_wallet.cf_sub_wallet_id","typeLabel":"string"},"name":{"type":"string","description":"Name for the sub-wallet.","example":"Gift Wallet","uniqueKey":"sub_wallet.name","typeLabel":"string"},"type":{"type":"string","description":"Type of the sub-wallet.","example":"GIFT_PPI","uniqueKey":"sub_wallet.type","typeLabel":"string"},"status":{"type":"string","description":"Status of the sub-wallet.","example":"ACTIVE","uniqueKey":"sub_wallet.status","typeLabel":"string"},"balance":{"type":"number","format":"double","description":"Current balance of the sub-wallet.","example":1500.75,"uniqueKey":"sub_wallet.balance","typeLabel":"number\u003cdouble>"},"available_balance":{"type":"number","format":"double","description":"Available balance in the sub-wallet.","example":1500.75,"uniqueKey":"sub_wallet.available_balance","typeLabel":"number\u003cdouble>"},"funds_on_hold":{"type":"number","format":"double","description":"Funds on hold in the sub-wallet.","example":0,"uniqueKey":"sub_wallet.funds_on_hold","typeLabel":"number\u003cdouble>"}},"uniqueKey":"sub_wallet","typeLabel":"object"},"status":{"type":"string","description":"Status of the transfer operation.\n","enum":["RECEIVED","PENDING","SUCCESS","FAILED","REJECTED","VALIDATION_PENDING","REVERSED","APPROVAL_PENDING","QUEUED","MANUALLY_REJECTED"],"example":"PENDING","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"bank_ref_no":{"oneOf":[{"type":"string","description":"Bank reference number for the transfer. Will be null if transfer is not yet processed.","example":"BNK202502101530001","uniqueKey":"bank_ref_no.oneOf.0","typeLabel":"string"},{"type":"null","description":"Bank reference number for the transfer. Will be null if transfer is not yet processed.","example":"BNK202502101530001","uniqueKey":"bank_ref_no.oneOf.1","typeLabel":"null"}],"uniqueKey":"bank_ref_no","typeLabel":"string | null"},"status_code":{"type":"string","description":"Status code for detailed tracking of transfer progress.\n","example":"TRANSFER_INITIATED","uniqueKey":"status_code","typeLabel":"string"},"bene_details":{"type":"object","description":"Beneficiary details used for the transfer.","properties":{"bene_id":{"type":"string","description":"Beneficiary ID assigned by Cashfree.","example":"BENE789","uniqueKey":"bene_details.bene_id","typeLabel":"string"},"cf_bene_instrument_id":{"type":"string","description":"Instrument ID assigned by Cashfree for the beneficiary.","example":"INST123456","uniqueKey":"bene_details.cf_bene_instrument_id","typeLabel":"string"},"instrument_details":{"oneOf":[{"type":"object","description":"Instrument details used for the transfer.","properties":{"bank_account_number":{"type":"string","description":"Bank account number of the beneficiary.","example":"1234567890","uniqueKey":"bene_details.instrument_details.oneOf.0.bank_account_number","typeLabel":"string"},"ifsc":{"type":"string","description":"IFSC code of the beneficiary's bank.","example":"HDFC0000123","uniqueKey":"bene_details.instrument_details.oneOf.0.ifsc","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"bene_details.instrument_details.oneOf.0","typeLabel":"object"},{"type":"object","description":"Instrument details used for the transfer.","properties":{"vpa":{"type":"string","description":"Virtual Payment Address (UPI ID) of the beneficiary.","example":"john.doe@paytm","uniqueKey":"bene_details.instrument_details.oneOf.1.vpa","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"bene_details.instrument_details.oneOf.1","typeLabel":"object"}],"uniqueKey":"bene_details.instrument_details","typeLabel":"object"}},"uniqueKey":"bene_details","typeLabel":"object"},"purpose":{"type":"string","description":"Purpose of the transfer.","example":"SALARY","uniqueKey":"purpose","typeLabel":"string"},"remarks":{"type":"string","description":"Remarks for the transfer transaction.","example":"Monthly groceries transfer","uniqueKey":"remarks","typeLabel":"string"},"notes":{"type":"object","description":"Optional key-value pairs for any extra information. Keys and values must be strings. The following constraints apply:\n- Maximum 10 entries.\n- Keys: maximum 50 characters. Alphanumeric characters, underscores (_), periods (.), commas (,), single quotes ('), ampersands (\u0026), hyphens (-), and spaces are allowed.\n- Values: maximum 200 characters. Same character set as keys.\n","properties":{"example_key":{"type":"string","description":"A note value. Maximum 200 characters. Alphanumeric characters, underscores (_), periods (.), commas (,), single quotes ('), ampersands (\u0026), hyphens (-), and spaces are allowed.","example":"example_value","uniqueKey":"notes.example_key","typeLabel":"string"}},"uniqueKey":"notes","typeLabel":"object"},"initiated_at":{"type":"string","format":"date-time","description":"Timestamp when the transfer transaction was initiated.","example":"2025-09-02T10:15:30Z","uniqueKey":"initiated_at","typeLabel":"string\u003cdate-time>"},"processed_at":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the transfer transaction was processed. Will be null if still pending.","example":"2025-09-02T10:17:45Z","uniqueKey":"processed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the transfer transaction was processed. Will be null if still pending.","example":"2025-09-02T10:17:45Z","uniqueKey":"processed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"processed_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"transfer_verify_success_response":{"title":"transfer_verify_success_response","value":{"user_id":"USER827364","wallet_id":"WALLET936721","cf_transfer_id":"8901234567890123456","transfer_id":"TRANSFER123456","amount":500.75,"transfer_mode":"NEFT","sub_wallet":{"cf_sub_wallet_id":"35246543210987654321","name":"Cashfree payout Wallet","type":"FULL_KYC_PPI","status":"ACTIVE","balance":9500.86,"available_balance":9500.86,"funds_on_hold":0},"status":"PENDING","status_code":"TRANSFER_INITIATED","bank_ref_no":null,"bene_details":{"bene_id":"BENE123","cf_bene_instrument_id":"35246543210987654323","instrument_details":{"bank_account_number":"1234567890","ifsc":"HDFC0000123"}},"purpose":"BUSINESS","remarks":"Vendor payment","notes":{"example_key":"example_value"},"initiated_at":"2025-09-02T10:15:30Z","processed_at":null}}},"exampleType":"examples"}},"exampleType":"examples"},"533ac638-c878-4140-acf5-3a72f8131f50":{"description":"Bad request - Invalid OTP, expired OTP, validation failure, or attempts exhausted.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"otp_invalid":{"title":"otp_invalid","value":{"code":"otp_invalid","type":"validation_error","message":"The provided OTP is incorrect"}},"otp_expired":{"title":"otp_expired","value":{"code":"otp_expired","type":"validation_error","message":"The provided OTP has expired"}},"otp_verification_exhausted":{"title":"otp_verification_exhausted","value":{"code":"otp_verification_attempt_exhausted","type":"validation_error","message":"Maximum OTP verification attempts exceeded"}},"transfer_id_missing":{"title":"transfer_id_missing","description":"Missing transfer_id","value":{"type":"validation_error","code":"transfer_id_missing","message":"transfer_id parameter missing in the request"}}},"exampleType":"examples"}},"exampleType":"examples"},"527887c1-344c-4d33-b0ae-4665703e0758":{"description":"Unauthorised - Invalid or missing authentication.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidCredentials":{"title":"invalidCredentials","value":{"code":"authentication_failed","type":"authentication_error","message":"Invalid client ID and client secret combination"}}},"exampleType":"examples"}},"exampleType":"examples"},"e69f9b06-621f-4ca2-ae77-bc710008f860":{"description":"Forbidden - Access denied.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"ipNotWhitelisted":{"title":"ipNotWhitelisted","value":{"code":"ip_not_whitelisted","type":"authentication_error","message":"Authentication error (IP not whitelisted)"}}},"exampleType":"examples"}},"exampleType":"examples"},"effb37fc-9740-4e34-98e7-cf44cdbfc3d9":{"description":"Not found - Transfer not found or not awaiting OTP verification.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"transferNotFound":{"title":"transferNotFound","value":{"code":"transfer_id_not_found","type":"validation_error","message":"No transfer found with the provided transfer_id"}}},"exampleType":"examples"}},"exampleType":"examples"},"9296afc5-7980-4bce-af4a-5f3cd85eb36d":{"description":"Too Many Requests - Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"internalError":{"title":"internalError","value":{"code":"too_many_requests_per_operation","type":"rate_limit_error","message":"Rate limit exceeded. Please try again after some time"}}},"exampleType":"examples"}},"exampleType":"examples"},"5c852f26-6198-4ed1-aace-33f7d71ef4d3":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A broad category of the error.","example":"internal_error","uniqueKey":"type","typeLabel":"string"},"code":{"type":"string","description":"A machine-readable error code specific to the issue.","example":"internal_server_error","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"A message providing more details about the error, dynamic based on the specific issue.","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"internalError":{"title":"internalError","value":{"code":"internal_server_error","type":"internal_error","message":"An internal error occurred while processing the request"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"5c2d9c0e-3813-4492-9995-1683368012ba":{"XClientID":{"type":"apiKey","in":"header","name":"x-client-id","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","scopes":[],"schemeName":"XClientID"},"XClientSecret":{"type":"apiKey","in":"header","name":"x-client-secret","description":"The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","scopes":[],"schemeName":"XClientSecret"}}},"servers":{"8cee66d8-0b87-41ef-ab76-cce054584ced":{"url":"https://api.cashfree.com","description":"Production server."},"f7bb6ace-47fa-4bed-99e0-0765bd0613d1":{"url":"https://sandbox.cashfree.com","description":"Sandbox server."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-client-id","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","scopes":[],"schemeName":"XClientID"},"schema":{"title":"x-client-id","type":"string","description":"Your unique client identifier issued by Cashfree. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"XClientID","name":"x-client-id"},{"scheme":{"type":"apiKey","in":"header","name":"x-client-secret","description":"The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","scopes":[],"schemeName":"XClientSecret"},"schema":{"title":"x-client-secret","type":"string","description":"The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your [Merchant Dashboard](https://merchant.cashfree.com/merchants/landing?env=prod).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"XClientSecret","name":"x-client-secret"}],"title":"XClientID \u0026 XClientSecret"}]},"originalFileLocation":"openapi/ppi/ppi.yaml"},"subdomain":"cashfreepayments-d00050e9","siteName":"Cashfree Developer Documentation","title":"Verify Transfer API | Cashfree","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"manual"},"contextualStarterQuestions":[{"_id":"6a79b1783629fc88876dff90","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I check transfer status?","status":"active","generatedBy":"contextual","path":"api-reference/prepaid-payment-instruments/transfers/verify-transfer","createdAt":"2026-08-10T11:09:44.500Z","updatedAt":"2026-08-10T11:09:44.500Z","__v":0},{"_id":"6a79b1783629fc88876dff8f","deploymentId":"66d5827f2de686bc28e7722b","questionText":"What's the OTP retry limit?","status":"active","generatedBy":"contextual","path":"api-reference/prepaid-payment-instruments/transfers/verify-transfer","createdAt":"2026-08-10T11:09:44.500Z","updatedAt":"2026-08-10T11:09:44.500Z","__v":0},{"_id":"6a79b1783629fc88876dff8e","deploymentId":"66d5827f2de686bc28e7722b","questionText":"How do I submit an OTP?","status":"active","generatedBy":"contextual","path":"api-reference/prepaid-payment-instruments/transfers/verify-transfer","createdAt":"2026-08-10T11:09:44.500Z","updatedAt":"2026-08-10T11:09:44.500Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-21T12:26:30.138Z","originalFileLocation":"api-reference/prepaid-payment-instruments/transfers/verify-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=\"light\"}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=\"Submits the OTP for a wallet transfer that was initiated with mode OTP_VERIFICATION. Use Get Transfer Details or webhooks for terminal status.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_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=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Verify Transfer API | Cashfree\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit the OTP shared with the Cashfree PPI wallet user to authorise an initiated transfer so the partner bank can complete the payout to the beneficiary.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cashfreepayments-d00050e9.mintlify.app/_mintlify/api/og/v2?division=Transfers\u0026amp;title=Verify+Transfer\u0026amp;description=Submits+the+OTP+for+a+wallet+transfer+that+was+initiated+with+mode+%60OTP_VERIFICATION%60.+%0AUse+**Get+Transfer+Details**+or+webhooks+for+terminal+status.%0A\u0026amp;theme=2adde9c6a50d91a75e16dbfe\u0026amp;signature=36c17597a04b44027ede69f9de082433f750b3ccebb894d7bd9bcc8643a285c4\">\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=\"Verify Transfer API | Cashfree\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit the OTP shared with the Cashfree PPI wallet user to authorise an initiated transfer so the partner bank can complete the payout to the beneficiary.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cashfreepayments-d00050e9.mintlify.app/_mintlify/api/og/v2?division=Transfers\u0026amp;title=Verify+Transfer\u0026amp;description=Submits+the+OTP+for+a+wallet+transfer+that+was+initiated+with+mode+%60OTP_VERIFICATION%60.+%0AUse+**Get+Transfer+Details**+or+webhooks+for+terminal+status.%0A\u0026amp;theme=2adde9c6a50d91a75e16dbfe\u0026amp;signature=36c17597a04b44027ede69f9de082433f750b3ccebb894d7bd9bcc8643a285c4\">\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=\"/docs/mintlify-assets/_mintlify/favicons/cashfreepayments-d00050e9/MP8bOqKxh3TohVa1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cashfree Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6930ca\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"T69Ao_T0Ps8pkRbluKzW179qvd_aCsWISCApeSsIhRU\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.cashfree.com/#organization\",\"name\":\"Cashfree Developer Documentation\",\"url\":\"https://www.cashfree.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cashfreepayments-d00050e9/6mQw7is1us8FhXrb/static/logo/light.svg?fit=max\u0026auto=format\u0026n=6mQw7is1us8FhXrb\u0026q=85\u0026s=8a2837083063d8a01e0be6b454a1baf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.cashfree.com/docs#website\",\"name\":\"Cashfree Developer Documentation\",\"url\":\"https://www.cashfree.com/docs\",\"publisher\":{\"@id\":\"https://www.cashfree.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer#webpage\",\"url\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer\",\"name\":\"Verify Transfer\",\"description\":\"Submits the OTP for a wallet transfer that was initiated with mode OTP_VERIFICATION. Use Get Transfer Details or webhooks for terminal status.\",\"dateModified\":\"2026-04-21T12:26:30.138Z\",\"isPartOf\":{\"@id\":\"https://www.cashfree.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Prepaid Payment Instrument APIs\",\"item\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transfers\",\"item\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/initiate-transfer\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Verify Transfer\",\"item\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer#apireference\",\"headline\":\"Verify Transfer\",\"name\":\"Verify Transfer\",\"description\":\"Submits the OTP for a wallet transfer that was initiated with mode OTP_VERIFICATION. Use Get Transfer Details or webhooks for terminal status.\",\"url\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer\",\"mainEntityOfPage\":{\"@id\":\"https://www.cashfree.com/docs/api-reference/prepaid-payment-instruments/transfers/verify-transfer#webpage\"},\"dateModified\":\"2026-04-21T12:26:30.138Z\",\"keywords\":\"verify transfer, wallet transfers, PPI, API reference, fund transfer\",\"publisher\":{\"@id\":\"https://www.cashfree.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.cashfree.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cashfree Developer Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cashfree Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Payments","pages":[{"title":"Payments","href":"/payments/introduction"}]},{"tab":"Payouts","pages":[{"title":"Payouts","href":"/payouts/payouts/introduction"}]},{"tab":"Secure ID","pages":[{"title":"Secure ID","href":"/secure-id/introduction"}]},{"tab":"Partners and Platforms","pages":[{"title":"Partners and Platforms","href":"/partners/introduction"}]},{"tab":"Payments APIs","hidden":true,"pages":[{"title":"Payments APIs","href":"/api-reference/payments/overview"}]},{"tab":"Payouts APIs","hidden":true,"pages":[{"title":"Payouts APIs","href":"/api-reference/payouts/overview"}]},{"tab":"Secure ID APIs","hidden":true,"pages":[{"title":"Secure ID APIs","href":"/api-reference/vrs/overview"}]},{"tab":"Additional APIs","hidden":true,"groups":[{"group":"Prepaid Payment Instrument APIs","pages":[{"title":"Overview","sidebarTitle":"Overview","description":"Integrate and manage PPI APIs for wallet creation, balance checks, and transaction management in digital payments.","href":"/api-reference/prepaid-payment-instruments/overview"},{"title":"Getting Started","sidebarTitle":"Getting Started","description":"Get started with the Cashfree PPI APIs by reviewing endpoints, generating API keys, configuring webhooks, and contacting Cashfree for production access.","href":"/api-reference/prepaid-payment-instruments/getting-started"},{"title":"PPI Webhooks","sidebarTitle":"Webhooks","icon":"webhook","description":"Index of prepaid instrument (PPI) wallet webhooks, including credit events, wallet notifications, and HMAC verification for JSON payloads.","href":"/api-reference/prepaid-payment-instruments/webhooks-overview"},{"title":"Webhook Signature Verification","sidebarTitle":"Webhook Signature Verification","description":"Verify Cashfree PPI webhook signatures using your client secret and the supplied timestamp header to confirm authenticity before processing wallet events.","icon":"webhook","iconType":"solid","href":"/api-reference/prepaid-payment-instruments/webhook-signature-verification"},{"group":"Users","pages":[{"openapi":"openapi/ppi/ppi.yaml post /ppi/user","title":"Create User","description":"Creates a new user in the PPI system with the provided personal information. This endpoint enables merchants \nto onboard new users who can then be associated with wallets or cards.\n","href":"/api-reference/prepaid-payment-instruments/user-management/create-ppi-user"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/user/details","title":"Get User Details","description":"Retrieves details of an existing user in the PPI system based on the provided user ID.\nReturns the user's personal information and account status.\n","href":"/api-reference/prepaid-payment-instruments/user-management/get-ppi-user-details"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/user/update","title":"Update User","description":"Updates user details in the PPI system. Only the fields provided in the request body will be updated; \nall other user fields remain unchanged.\n","href":"/api-reference/prepaid-payment-instruments/user-management/update-ppi-user"}]},{"group":"User KYC","pages":[{"openapi":"openapi/ppi/ppi.yaml post /ppi/kyc/vkyc","title":"Initiate Video KYC","description":"Initiates Video KYC for a user and generates a VKYC link.\nThis endpoint creates a VKYC verification request and sends the notification across\nthe requested channels.\n","href":"/api-reference/prepaid-payment-instruments/kyc-verification/video-kyc-verification"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/kyc/vkyc/details","title":"Get Video KYC Details","description":"Retrieves the current status and other details of a Video KYC verification request, using the `user_id` and `verification_id` you supplied while initiating the request.\n","href":"/api-reference/prepaid-payment-instruments/kyc-verification/get-video-kyc-status"},{"title":"Video KYC Webhooks","sidebarTitle":"Video KYC Webhooks","description":"Configure Video KYC webhooks to receive real-time notifications when VKYC verification status changes in your PPI integration.","icon":"webhook","href":"/api-reference/prepaid-payment-instruments/kyc-verification/webhook-vkyc"},{"title":"VKYC Status and Status-Code Mapping","sidebarTitle":"VKYC Status Mapping","description":"Reference for PPI Video KYC status and status-code combinations returned by VKYC APIs and webhooks, with recommended actions for each scenario.","icon":"list","href":"/api-reference/prepaid-payment-instruments/kyc-verification/vkyc-status-descriptions"}]},{"group":"Wallets","pages":[{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet","title":"Create Wallet","description":"Creates a primary wallet and the associated sub-wallets for a user based on the specified program ID. The sub-wallet types, such as meal, fuel, and gift wallets, are determined by the program configuration. If the program is linked to a card program, a card is automatically created and associated with the wallet.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/create-wallet"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/credit","title":"Credit Wallet","description":"Credits funds to a specified user sub-wallet, adding money to their available balance. Supports various sub-wallet types with behaviour determined by wallet configuration.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/credit-wallet"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/debit","title":"Debit Wallet","description":"Debits funds from a user's sub-wallet for purchases. The behaviour varies based on the sub-wallet type:\n\n- `GIFT_PPI`: Identifies the applicable gift card and debits the amount transactionally from both the gift card and the gift wallet. This debit completes in a single step and does not require OTP verification.\n\n- `CLOSED_LOOP_PPI`: Performs ledger maintenance only. No actual money movement occurs.\n\n- `SMALL_PPI` and `FULL_KYC_PPI`: The debit uses a two-step flow that requires OTP verification.\n 1. In your request, include the `auth` object with `mode` set to `OTP_VERIFICATION` and specify at least one channel in `auth.data.notification_modes`.\n 2. Cashfree records the request, generates an OTP, and returns a response with `status: PENDING` and `status_code: OTP_GENERATED`.\n 3. Call the [Verify Debit Wallet](/api-reference/prepaid-payment-instruments/wallet-management/verify-debit-wallet) API with the `debit_id` and OTP to complete the debit. On successful verification, the status moves to `SUCCESS`.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/debit-wallet"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/debit/verify","title":"Verify Debit Wallet","description":"Completes a debit transaction that requires OTP verification for SMALL_PPI or FULL_KYC_PPI sub-wallets. Use this endpoint after the [Debit Wallet API](/api-reference/prepaid-payment-instruments/wallet-management/debit-wallet) returns status_code: OTP_GENERATED. Pass the debit_id from that response along with the OTP received by the customer through the channels configured in auth.data.notification_modes. On successful verification, the API returns status: SUCCESS and status_code: SUCCESS, and the debit transaction is completed. Each debit_id supports a maximum of three OTP verification attempts.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/verify-debit-wallet"},{"title":"Debit Status and Status-Code Mapping","sidebarTitle":"Debit Status Mapping","description":"Understand debit status and status_code combinations returned by PPI Debit Wallet and Verify Debit Wallet APIs, with recommended actions for each scenario.","icon":"list","href":"/api-reference/prepaid-payment-instruments/wallet-management/debit-status-descriptions"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/refund","title":"Refund Debit Wallet","description":"Processes a refund for a previously debited transaction from a user's sub-wallet. The refund operation \ncredits the amount back to the user's sub-wallet, effectively reversing a debit transaction:\n- `GIFT_PPI`: Credits amount back to gift wallet.\n- `CLOSED_LOOP_PPI`: Credits amount back to the respective sub-wallet.\n- `STANDARD_PPI`: Credits amount back to the respective sub-wallet.\n- Refund amount cannot exceed the original debit amount.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/refund-wallet"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/closure","title":"Close Wallet","description":"Closes a user's sub-wallet, making it inactive for future transactions. The closure process may require approval \ndepending on the sub-wallet type and business rules:\n- Any remaining balance is handled according to the configured closure policy.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/close-wallet"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/eligibility","title":"Check Transaction Eligibility","description":"Validates a user’s eligibility to perform credit or debit transactions on a sub-wallet based on compliance rules.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/check-wallet-eligibility"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/details","title":"Get Wallet Details","description":"Use this API to fetch wallet details and associated sub-wallet balances for a specified user. You can query by wallet ID, card ID, or a combination of either with a sub-wallet ID.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/get-wallet-details"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/statement","title":"Get Wallet Statement","description":"Retrieves a paginated wallet statement for a user, including both credit and debit transactions for a specific sub-wallet.\n- The statement can be fetched for a specified date range. If no range is provided, the API returns transactions from the last 6 months.\n- The `from` date **cannot** be earlier than 1 year from the current date.\n- Pagination is handled using the `after` and `before` parameters, which define the `cf_statement_id` boundary for retrieving the next or previous set of records.\n- Only **one** of `after` or `before` can be passed at a time.\n","href":"/api-reference/prepaid-payment-instruments/wallet-management/get-wallet-statement"},{"title":"Wallet Webhooks","sidebarTitle":"Wallet Webhooks","description":"Configure Cashfree wallet webhooks to receive credit, debit, and refund event notifications in your prepaid instrument integration.","icon":"webhook","href":"/api-reference/prepaid-payment-instruments/wallet-management/webhook-wallet"},{"title":"Card Webhooks","sidebarTitle":"Card Webhooks","description":"Configure Cashfree Card webhooks to receive event-based notifications whenever card transactions, refunds or card status updates occur in your PPI integration.","icon":"webhook","href":"/api-reference/prepaid-payment-instruments/wallet-management/webhook-card"}]},{"group":"Beneficiaries","pages":[{"openapi":"openapi/ppi/ppi.yaml post /ppi/user/bene","title":"Create Beneficiary","description":"Creates a new beneficiary to user's Full KYC wallet by providing bank account number or VPA and other required details. Ensure the successful creation of the beneficiary before initiating a fund transfer.\n","href":"/api-reference/prepaid-payment-instruments/user-beneficiary/create-user-bene"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/user/bene/details","title":"Get Beneficiary Details","description":"Retrieves details of an existing beneficiary of user in the PPI system.\n- If `bene_instrument_id` is provided, the response includes details for the specified instrument only.\n- If `bene_instrument_id` is not provided, the response includes details for all `bene_instruments` linked to the given `bene_id`.\n","href":"/api-reference/prepaid-payment-instruments/user-beneficiary/get-user-bene"},{"openapi":"openapi/ppi/ppi.yaml delete /ppi/user/bene/remove","title":"Remove Beneficiary","description":"Removes an existing beneficiary of the user in the PPI system.\n- If `bene_instrument_id` is provided, only the specified instrument is removed from the beneficiary.\n- If `bene_instrument_id` is not provided, the entire beneficiary along with all its `bene_instruments` is removed.\n","href":"/api-reference/prepaid-payment-instruments/user-beneficiary/remove-user-bene"}]},{"group":"Transfers","pages":[{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/transfer","title":"Initiate Transfer","description":"Initiates a fund transfer from a user's FULL_KYC_PPI sub-wallet to a beneficiary account. Supports multiple transfer modes including RTGS, NEFT, IMPS, and UPI. It is an async request by default.\n\nThe beneficiary can be specified using either:\n- Existing beneficiary ID and instrument ID\n- New instrument details (bank account or UPI)\n","href":"/api-reference/prepaid-payment-instruments/transfers/initiate-transfer"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/transfer/verify","title":"Verify Transfer","href":"/api-reference/prepaid-payment-instruments/transfers/verify-transfer"},{"openapi":"openapi/ppi/ppi.yaml post /ppi/wallet/transfer/details","title":"Get Transfer Details","description":"Retrieves detailed information about a specific transfer transaction, including current status, beneficiary details.\n\nThis endpoint provides comprehensive transfer information including:\n- Current transfer status and bank status\n- Beneficiary and instrument details\n- Transaction timestamps and reference numbers if transaction successfully completed\n- Sub-wallet balance after the transfer\n","href":"/api-reference/prepaid-payment-instruments/transfers/get-transfer-details"},{"title":"Transfer Webhook Events","sidebarTitle":"Transfer Webhooks","description":"Configure Transfer webhooks to receive event-based notifications whenever a wallet transfer changes status in your PPI integration.","icon":"webhook","href":"/api-reference/prepaid-payment-instruments/transfers/webhook-transfer"}]}]}]},{"tab":"Partners APIs","hidden":true,"pages":[{"title":"Partners APIs","href":"/api-reference/platforms/overview"}]},{"tab":"Additional APIs","hidden":true,"pages":[{"title":"Additional APIs","href":"/api-reference/other-apis/bbps/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"AI Stack","pages":[{"title":"AI Stack","href":"/tools-ai/overview"}]},{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/overview"}]}]},"title":"Verify Transfer API | Cashfree","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-2jF_ccbi.js","utils-NNMVb_sb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DdtBhtt6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D1OxL5O8.js","snippetPresets-DDC-KAXp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BOnTqOyQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EEWI6FIO.js","shallow-fGZcWzm2.js","getApiPlaygroundDisplay-B3B8qEvw.js","CodeSnippet-BG9nsSU4.js","CodeSnippets-BlRACLKl.js","Page-FtoC8lZ9.js","getPastedJson-COV-Kgnr.js","icon-BXu3lasn.js","MethodPill-DGMUqJKh.js","DuplicateIcon-JEUJDHz_.js","createIcon-BDFucJ34.js","DynamicMarkdown-34OtG_BH.js","SectionHeading-tBbRD59j.js","axios-vUo_bRtp.js","Markdown-SoRz2nk2.js","clsx-BOmkPVIU.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DN0dCbTw.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BcsLYcfW.js"]}