Every Grain payment moves through a defined set of stages — from checkout to final settlement. Understanding this flow helps you build better integrations and set clear expectations for your customers.
Refunds can be initiated by either the customer or the merchant, following the merchant’s refund policy. Here is how the refund process works:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Grain","colors":{"primary":"#4b4847","light":"#cdc2af","dark":"#4b4847"},"logo":{"light":"https://mintcdn.com/grain/NdV47NtMcDFGBfow/logo/light.svg?fit=max\u0026auto=format\u0026n=NdV47NtMcDFGBfow\u0026q=85\u0026s=deae0a3295bc245d29aca19c53ec202a","dark":"https://mintcdn.com/grain/NdV47NtMcDFGBfow/logo/dark.svg?fit=max\u0026auto=format\u0026n=NdV47NtMcDFGBfow\u0026q=85\u0026s=b348302a851894275d54aa34ef76efad"},"favicon":{"light":"https://mintcdn.com/grain/NdV47NtMcDFGBfow/favicon-light.svg?fit=max\u0026auto=format\u0026n=NdV47NtMcDFGBfow\u0026q=85\u0026s=5cc0c73a4d75f8b39d5b1ea053cd414a","dark":"https://mintcdn.com/grain/NdV47NtMcDFGBfow/favicon-dark.svg?fit=max\u0026auto=format\u0026n=NdV47NtMcDFGBfow\u0026q=85\u0026s=046bf4182908d69cda9157838ad16ee6"},"navbar":{"links":[{"href":"mailto:contact@grain.inc","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/GrainPayments","linkedin":"https://www.linkedin.com/company/graininc"}},"contextual":{"options":[],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"grain","hasAudioNarration":false,"actualSubdomain":"grain","customDomains":["docs.grain.inc"],"gitSource":{"type":"github","owner":"grain-inc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa09c2d6987b2ebec308156","collectionId":"4cbdf98c-e7d8-4aab-a407-11faafa27996","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa09c2d6987b2ebec308156"},"entitlements":{},"buildId":"6aa09c2d6987b2ebec308156","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Grain Dashboard","count":13},{"language":"default","tag":"Payment SDK","count":10},{"language":"default","tag":"Configuring Settings","count":6},{"language":"default","tag":"Get Started","count":5},{"language":"default","tag":"Integration Guide","count":4},{"language":"default","tag":"How Grain Works","count":3},{"language":"default","tag":"Managing Transactions","count":3},{"language":"default","tag":"Your Business at a Glance","count":3},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"Support \u0026 Resources","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navigation-items>div.mt-6{border-top:1px solid #e5e5e5;padding-top:16px}.dark #navigation-items>div.mt-6{border-top-color:#333}"}],"page":{"pagePath":"how-grain-works/payment-lifecycle","slug":"/how-grain-works/payment-lifecycle","pageMetadata":{"title":"Payment Lifecycle","description":"Understand each stage of a Grain payment from initiation to settlement","icon":"arrows-spin","href":"/how-grain-works/payment-lifecycle"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Understand each stage of a Grain payment from initiation to settlement\"\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`,hr:`hr`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Steps}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`payment-flow`,children:`Payment Flow`}),`\n`,_jsx(_components.p,{children:`Every Grain payment moves through a defined set of stages — from checkout to final settlement. Understanding this flow helps you build better integrations and set clear expectations for your customers.`}),`\n`,_jsxs(Steps,{children:[_jsx(Heading,{level:`3`,id:`customer-initiates-payment`,children:`Customer Initiates Payment`}),_jsxs(_components.p,{children:[`The customer interacts with your payment module and selects `,_jsx(_components.strong,{children:`Pay with Crypto`}),`. Grain’s API generates a prefilled payment link containing the destination address, token, and amount. The customer is prompted to review, agree, and sign the transaction.`]}),_jsxs(_components.p,{children:[`If the customer does not agree or sign, the transaction is marked as `,_jsx(_components.strong,{children:`rejected`}),` and the payment is `,_jsx(_components.strong,{children:`cancelled`}),`.`]}),_jsxs(_components.p,{children:[`Once the customer signs the transaction, it undergoes Grain’s automated compliance screening. After screening passes, the funds are delivered to a `,_jsx(_components.strong,{children:`one-time storage wallet`}),` generated by Grain. The payment enters a settlement hold period while awaiting final settlement.`]}),_jsxs(_components.p,{children:[`If a refund is requested during this period, the refund process begins (see `,_jsx(_components.a,{href:`#refund-flow`,children:`Refund Flow`}),` below). If no refund is requested and the settlement period has passed, the transaction is `,_jsx(_components.strong,{children:`captured`}),`.`]}),_jsxs(_components.p,{children:[`Once a transaction has been `,_jsx(_components.strong,{children:`captured`}),`, your merchant account balance is `,_jsx(_components.strong,{children:`credited`}),` and funds are ready to be `,_jsx(_components.strong,{children:`disbursed`}),` based on your elected settlement method.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`refund-flow`,children:`Refund Flow`}),`\n`,_jsx(_components.p,{children:`Refunds can be initiated by either the customer or the merchant, following the merchant’s refund policy. Here is how the refund process works:`}),`\n`,_jsxs(Steps,{children:[_jsx(Heading,{level:`3`,id:`refund-requested`,children:`Refund Requested`}),_jsx(_components.p,{children:`A refund is initiated by the user or merchant according to the merchant’s refund policy. The request appears in your Grain Dashboard for review.`}),_jsx(Heading,{level:`3`,id:`merchant-review`,children:`Merchant Review`}),_jsx(_components.p,{children:`You review the refund request on your Dashboard. You can approve or deny the request based on your refund policy and the details of the transaction.`}),_jsx(Heading,{level:`3`,id:`refund-decision`,children:`Refund Decision`}),_jsxs(_components.p,{children:[`If approved, funds are sent back to the customer’s `,_jsx(_components.strong,{children:`original payment address`}),` from the generated one-time payment address.`]}),_jsxs(_components.p,{children:[`If denied, the refund request is rejected and the held funds are deposited to your `,_jsx(_components.strong,{children:`merchant account balance`}),`.`]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Payment Lifecycle","description":"Understand each stage of a Grain payment from initiation to settlement","icon":"arrows-spin","href":"/how-grain-works/payment-lifecycle"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Payment Flow","slug":"payment-flow","depth":2,"children":[{"title":"Customer Initiates Payment","slug":"customer-initiates-payment","depth":3,"children":[]}]},{"title":"Refund Flow","slug":"refund-flow","depth":2,"children":[{"title":"Refund Requested","slug":"refund-requested","depth":3,"children":[]},{"title":"Merchant Review","slug":"merchant-review","depth":3,"children":[]},{"title":"Refund Decision","slug":"refund-decision","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"grain","siteName":"Grain","title":"Payment Lifecycle - Grain","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-24T18:47:23.720Z","originalFileLocation":"how-grain-works/payment-lifecycle.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Understand each stage of a Grain payment from initiation to settlement\">\u003cmeta data-mint-head name=\"application-name\" content=\"Grain\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Payment Lifecycle - Grain\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand each stage of a Grain payment from initiation to settlement\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Grain\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.grain.inc/how-grain-works/payment-lifecycle\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://grain.mintlify.site/_mintlify/api/og/v2?division=How+Grain+Works\u0026amp;title=Payment+Lifecycle\u0026amp;description=Understand+each+stage+of+a+Grain+payment+from+initiation+to+settlement\u0026amp;theme=04029a7f16cda565d0454356\u0026amp;signature=5abb1d38ff45520a47d8f1005f1bd65cb088759835a1633a762a06e90664be3c\">\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=\"Payment Lifecycle - Grain\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand each stage of a Grain payment from initiation to settlement\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://grain.mintlify.site/_mintlify/api/og/v2?division=How+Grain+Works\u0026amp;title=Payment+Lifecycle\u0026amp;description=Understand+each+stage+of+a+Grain+payment+from+initiation+to+settlement\u0026amp;theme=04029a7f16cda565d0454356\u0026amp;signature=5abb1d38ff45520a47d8f1005f1bd65cb088759835a1633a762a06e90664be3c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/grain/-w3cyG4E7elnZnVe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Grain\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4b4847\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.grain.inc/how-grain-works/payment-lifecycle\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/how-grain-works/payment-lifecycle.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.grain.inc/#organization\",\"name\":\"Grain\",\"url\":\"https://docs.grain.inc\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/grain/NdV47NtMcDFGBfow/logo/light.svg?fit=max\u0026auto=format\u0026n=NdV47NtMcDFGBfow\u0026q=85\u0026s=deae0a3295bc245d29aca19c53ec202a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.grain.inc#website\",\"name\":\"Grain\",\"url\":\"https://docs.grain.inc\",\"publisher\":{\"@id\":\"https://docs.grain.inc/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle#webpage\",\"url\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle\",\"name\":\"Payment Lifecycle\",\"description\":\"Understand each stage of a Grain payment from initiation to settlement\",\"dateModified\":\"2026-03-24T18:47:23.720Z\",\"isPartOf\":{\"@id\":\"https://docs.grain.inc#website\"},\"breadcrumb\":{\"@id\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://docs.grain.inc/how-grain-works/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How Grain Works\",\"item\":\"https://docs.grain.inc/how-grain-works/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Payment Lifecycle\",\"item\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle#article\",\"headline\":\"Payment Lifecycle\",\"name\":\"Payment Lifecycle\",\"description\":\"Understand each stage of a Grain payment from initiation to settlement\",\"url\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle\",\"mainEntityOfPage\":{\"@id\":\"https://docs.grain.inc/how-grain-works/payment-lifecycle#webpage\"},\"dateModified\":\"2026-03-24T18:47:23.720Z\",\"publisher\":{\"@id\":\"https://docs.grain.inc/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.grain.inc#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Grain\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Grain","nav":{"global":null,"groups":[{"group":"Home","pages":[{"title":"Grain Documentation","href":"/index"}]},{"group":"Get Started","icon":"rocket","pages":[{"group":"How Grain Works","icon":"circle-info","expanded":false,"pages":[{"title":"Overview","description":"How Grain enables merchants to accept crypto payments","icon":"circle-info","href":"/how-grain-works/overview"},{"title":"Payment Lifecycle","icon":"arrows-spin","href":"/how-grain-works/payment-lifecycle"},{"title":"Settlement","description":"How and when you receive funds from completed payments","icon":"building-columns","href":"/how-grain-works/settlement"}]},{"group":"Onboarding \u0026 KYB","icon":"clipboard-check","expanded":false,"pages":[{"title":"KYB Requirements","icon":"clipboard-check","href":"/get-started/onboarding/kyb-requirements"},{"title":"Submitting the KYB Application","icon":"browser","href":"/get-started/onboarding/kyb-dashboard"}]}]},{"group":"Payment SDK","icon":"code","pages":[{"group":"Getting Started","icon":"play","expanded":false,"pages":[{"title":"Overview","icon":"cube","href":"/payment-sdk/overview"},{"title":"Installation \u0026 Setup","icon":"download","href":"/payment-sdk/installation-setup"}]},{"group":"Integration Guide","icon":"puzzle-piece","expanded":false,"pages":[{"title":"Initialize the SDK","icon":"play","href":"/payment-sdk/integration-guide/initialize-sdk"},{"title":"Create a Payment Session","icon":"credit-card","href":"/payment-sdk/integration-guide/create-payment-session"},{"title":"Handle Payment Completion","icon":"circle-check","href":"/payment-sdk/integration-guide/handle-payment-completion"},{"title":"Handle Errors \u0026 Edge Cases","icon":"triangle-exclamation","href":"/payment-sdk/integration-guide/handle-errors"}]},{"group":"Testing","icon":"flask","expanded":false,"pages":[{"title":"Test in Sandbox","icon":"flask","href":"/payment-sdk/testing/test-in-sandbox"}]},{"group":"API Reference","icon":"square-terminal","expanded":false,"pages":[{"title":"Authentication","icon":"key","href":"/payment-sdk/api-reference/authentication"},{"title":"Endpoints","icon":"code","href":"/payment-sdk/api-reference/endpoints"},{"title":"Error Codes","icon":"circle-xmark","href":"/payment-sdk/api-reference/error-codes"}]}]},{"group":"Grain Dashboard","icon":"chart-line","pages":[{"title":"Overview \u0026 Navigation","icon":"layout-dashboard","href":"/partner-dashboard/overview"},{"group":"Your Business at a Glance","icon":"gauge","expanded":false,"pages":[{"title":"Key Metrics","icon":"chart-simple","href":"/partner-dashboard/guide/key-metrics"},{"title":"Filters and Performance","icon":"filter","href":"/partner-dashboard/guide/filters-and-performance"},{"title":"Payouts and Recent Transactions","icon":"money-bill-transfer","href":"/partner-dashboard/guide/payouts-and-recent-transactions"}]},{"group":"Managing Transactions","icon":"receipt","expanded":false,"pages":[{"title":"Viewing Transactions","icon":"list","href":"/partner-dashboard/guide/viewing-transactions"},{"title":"Filtering and Searching","icon":"magnifying-glass","href":"/partner-dashboard/guide/filtering-and-searching"},{"title":"Transaction Details","icon":"receipt","href":"/partner-dashboard/guide/transaction-details"}]},{"group":"Configuring Settings","icon":"gear","expanded":false,"pages":[{"title":"API and Webhooks","icon":"code","href":"/partner-dashboard/guide/api-and-webhooks"},{"title":"Payment Settings","icon":"coins","href":"/partner-dashboard/guide/payment-settings"},{"title":"Team Management","icon":"users","href":"/partner-dashboard/guide/team-management"},{"title":"Security","icon":"shield-halved","href":"/partner-dashboard/guide/security"},{"title":"Notifications","icon":"bell","href":"/partner-dashboard/guide/notifications"},{"title":"Billing and Payouts","icon":"building-columns","href":"/partner-dashboard/guide/billing-and-payouts"}]}]},{"group":"Support \u0026 Resources","icon":"life-ring","pages":[{"title":"System Status","icon":"signal","href":"/support/system-status"},{"title":"Release Notes","icon":"clock-rotate-left","href":"/support/release-notes"},{"title":"Complaints","icon":"flag","href":"/support/complaints"}]}]},"basePath":"","title":"Payment Lifecycle - Grain","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":[],"chunks":[]}
