V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.
RiseID, address, or team nanoid of the paying team.
payee
stringnumber
required
RiseID, address, or user nanoid of the payee.
amount
stringnumber
required
Payment amount in micro-USD (1,000,000 = $1.00).
salt
stringnumber
required
Uniqueness value for this payment. Rise derives the payment on-chain id from (paying team account, payee, amount, salt); repeating that exact combination is rejected as a duplicate (HTTP 409). Salt alone is not the idempotency key — the same salt with a different payee or amount creates a distinct payment. Use external_id for a caller-controlled idempotency key.
Response
Default Response
data
object
required
Show child attributes
duplicates
object
Non-blocking warning returned by the sign step when payments matching an existing payee/amount within the lookback window are found. Informational only — it does not block signing or execution. The hard duplicate rejection (HTTP 409) happens at execute time, keyed on salt and external_id, not here.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rise API","description":"Global payroll for the modern workforce. Streamline payments to contractors and full-time employees around the globe with Rise's blockchain-first platform.","colors":{"primary":"#5e59ec","light":"#7c7aed","dark":"#4a46d9"},"logo":{"light":"https://cdn.prod.website-files.com/624f0c4263953ffe82f4e446/68092904f1a7fae9edc78b9b_RiseLogo.webp","dark":"https://cdn.prod.website-files.com/624f0c4263953ffe82f4e446/68092904f1a7fae9edc78b9b_RiseLogo.webp"},"favicon":"https://mintcdn.com/rise-067e2e54/psAvNyU-MYJCo5ek/favicon.svg?fit=max\u0026auto=format\u0026n=psAvNyU-MYJCo5ek\u0026q=85\u0026s=197e4f68fed11fd77a3075c2f55d7795","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"mailto:hello@riseworks.io","label":"Support"},{"href":"https://status.riseworks.io","label":"Status"},{"href":"https://www.riseworks.io","label":"Website"},{"href":"https://www.riseworks.io/blog","label":"Blog"},{"href":"https://trust.riseworks.io","label":"Trust"}],"primary":{"type":"button","label":"Get Started","href":"https://app.rise.works"}},"footer":{"socials":{"x":"https://x.com/riseworks","github":"https://github.com/riseworks","linkedin":"https://linkedin.com/company/riseworks"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rise-067e2e54","hasAudioNarration":false,"actualSubdomain":"rise-067e2e54","customDomains":["docs.riseworks.io"],"gitSource":{"type":"github","owner":"riseworks","repo":"b2b-integration-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff1642ca43cd02480339c1","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Webhooks","count":24},{"language":"default","tag":"V1 Legacy API Reference","count":17},{"language":"default","tag":"Teams","count":14},{"language":"default","tag":"Core Concepts","count":13},{"language":"default","tag":"Get Started","count":10},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Payments","count":9},{"language":"default","tag":"Authentication","count":8},{"language":"default","tag":"Platform Concepts","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference-v1/payments/prepare-instant-payment-v1-legacy","slug":"/api-reference-v1/payments/prepare-instant-payment-v1-legacy","pageMetadata":{"title":"Prepare instant payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml PUT /v1/payments/pay","description":"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking `duplicates` warning when a similar payment (same payee/amount) exists in the lookback window.","href":"/api-reference-v1/payments/prepare-instant-payment-v1-legacy"},"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 ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking \", _jsx(_components.code, {\n children: \"duplicates\"\n }), \" warning when a similar payment (same payee/amount) exists in the lookback window.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Prepare instant payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml PUT /v1/payments/pay","description":"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking `duplicates` warning when a similar payment (same payee/amount) exists in the lookback window.","href":"/api-reference-v1/payments/prepare-instant-payment-v1-legacy"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Prepare instant payment (V1 Legacy)","tags":["Payments"],"description":"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking `duplicates` warning when a similar payment (same payee/amount) exists in the lookback window.","requestBody":"5cf13994-7022-4daf-bdb6-05a839dc5d28","responses":{"200":"6624e110-b941-440c-8324-6a1a092a8432","400":"8fa1d8c7-b464-4c1e-a259-2b06f13e0271","401":"94e0e127-ccd2-41d1-afd1-7e57866f16cd","403":"31c426e3-01b5-4538-ab24-6142089d1223","404":"dbc10dc5-8309-428e-9ce0-5d67b36ddce8","500":"10da0cca-91c2-4143-a41b-7dacf3d6637f"},"method":"put","type":"path","servers":["21ceafb8-ac94-423c-ad24-9244a58665ba","2eb76bbb-f074-45d8-a59f-248d97e817a2","0d0671da-1b56-4fe6-8ee7-36a4fdaf8164"],"security":[],"path":"/v1/payments/pay","baseUrlOptions":["https://b2b-api.dev-riseworks.io","https://b2b-api.staging-riseworks.io","https://b2b-api.riseworks.io"],"title":"Prepare instant payment (V1 Legacy)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string","description":"Wallet address of the payer.","isRequired":true,"uniqueKey":"wallet","typeLabel":"string"},"rise_id":{"oneOf":[{"type":"string","description":"RiseID, address, or team nanoid of the paying team.","isRequired":true,"uniqueKey":"rise_id.oneOf.0","typeLabel":"string"},{"type":"number","description":"RiseID, address, or team nanoid of the paying team.","isRequired":true,"uniqueKey":"rise_id.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"rise_id","typeLabel":"string | number"},"payee":{"oneOf":[{"type":"string","description":"RiseID, address, or user nanoid of the payee.","isRequired":true,"uniqueKey":"payee.oneOf.0","typeLabel":"string"},{"type":"number","description":"RiseID, address, or user nanoid of the payee.","isRequired":true,"uniqueKey":"payee.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"payee","typeLabel":"string | number"},"amount":{"oneOf":[{"type":"string","description":"Payment amount in micro-USD (1,000,000 = $1.00).","isRequired":true,"uniqueKey":"amount.oneOf.0","typeLabel":"string"},{"type":"number","description":"Payment amount in micro-USD (1,000,000 = $1.00).","isRequired":true,"uniqueKey":"amount.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"amount","typeLabel":"string | number"},"salt":{"oneOf":[{"type":"string","description":"Uniqueness value for this payment. Rise derives the payment on-chain id from (paying team account, payee, amount, salt); repeating that exact combination is rejected as a duplicate (HTTP 409). Salt alone is not the idempotency key — the same salt with a different payee or amount creates a distinct payment. Use external_id for a caller-controlled idempotency key.","isRequired":true,"uniqueKey":"salt.oneOf.0","typeLabel":"string"},{"type":"number","description":"Uniqueness value for this payment. Rise derives the payment on-chain id from (paying team account, payee, amount, salt); repeating that exact combination is rejected as a duplicate (HTTP 409). Salt alone is not the idempotency key — the same salt with a different payee or amount creates a distinct payment. Use external_id for a caller-controlled idempotency key.","isRequired":true,"uniqueKey":"salt.oneOf.1","typeLabel":"number"}],"isRequired":true,"uniqueKey":"salt","typeLabel":"string | number"}},"required":["wallet","rise_id","payee","amount","salt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"wallet":"\u003cstring>","rise_id":"\u003cstring>","payee":"\u003cstring>","amount":"\u003cstring>","salt":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6624e110-b941-440c-8324-6a1a092a8432":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"domain":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.domain.additionalProperties","typeLabel":"any"},"description":"EIP-712 domain separator.","isRequired":true,"uniqueKey":"data.domain","typeLabel":"object"},"types":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.types.additionalProperties","typeLabel":"any"},"description":"EIP-712 type definitions.","isRequired":true,"uniqueKey":"data.types","typeLabel":"object"},"message":{"description":"EIP-712 typed-data message to sign.","isRequired":true,"uniqueKey":"data.message","typeLabel":"any"},"primaryType":{"type":"string","description":"EIP-712 primary type name.","isRequired":true,"uniqueKey":"data.primaryType","typeLabel":"string"},"descriptor":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.descriptor.additionalProperties","typeLabel":"any"},"description":"V1 instant-pay sign returned a descriptor object; V2 has no equivalent so this is always empty.","isRequired":true,"uniqueKey":"data.descriptor","typeLabel":"object"}},"required":["domain","types","message","primaryType","descriptor"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"duplicates":{"type":"object","properties":{"days_checked":{"type":"number","isRequired":true,"uniqueKey":"duplicates.days_checked","typeLabel":"number"},"payments":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].to","typeLabel":"string"},"amount_cents":{"type":"number","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].amount_cents","typeLabel":"number"},"currency_symbol":{"type":"string","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].currency_symbol","typeLabel":"string"},"invoice_description":{"type":"string","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].invoice_description","typeLabel":"string"},"payment_details":{"type":"string","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].payment_details","typeLabel":"string"},"external_id":{"type":"string","description":"external_id of the existing potentially-duplicate payment.","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].external_id","typeLabel":"string"},"created_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].created_at.oneOf.0","typeLabel":"string"},{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].created_at.oneOf.1","typeLabel":"string\u003cdate-time>"}],"isRequired":true,"uniqueKey":"duplicates.payments.items.[INDEX].created_at","typeLabel":"string | string\u003cdate-time>"}},"required":["to","amount_cents","currency_symbol","invoice_description","payment_details","external_id","created_at"],"additionalProperties":false,"uniqueKey":"duplicates.payments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"duplicates.payments","typeLabel":"object[]"}},"required":["days_checked","payments"],"additionalProperties":false,"description":"Non-blocking warning returned by the sign step when payments matching an existing payee/amount within the lookback window are found. Informational only — it does not block signing or execution. The hard duplicate rejection (HTTP 409) happens at execute time, keyed on salt and external_id, not here.","uniqueKey":"duplicates","typeLabel":"object"}},"required":["data"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"domain":{},"types":{},"message":"\u003cunknown>","primaryType":"\u003cstring>","descriptor":{}},"duplicates":{"days_checked":123,"payments":[{"to":"\u003cstring>","amount_cents":123,"currency_symbol":"\u003cstring>","invoice_description":"\u003cstring>","payment_details":"\u003cstring>","external_id":"\u003cstring>","created_at":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"8fa1d8c7-b464-4c1e-a259-2b06f13e0271":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["Bad Request"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_parameters"],"isRequired":true,"uniqueKey":"message.type","typeLabel":"enum\u003cstring>"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"message.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"message.errors.additionalProperties","typeLabel":"string[]"},"isRequired":true,"uniqueKey":"message.errors","typeLabel":"object"}},"required":["type","errors"],"additionalProperties":false,"isRequired":true,"uniqueKey":"message","typeLabel":"object"}},"required":["error","message"],"additionalProperties":false,"description":"Bad Request - Invalid parameters","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Bad Request","message":{"type":"invalid_parameters","errors":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"94e0e127-ccd2-41d1-afd1-7e57866f16cd":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"string","isRequired":true,"uniqueKey":"data","typeLabel":"string"},"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"}},"required":["success","data"],"additionalProperties":false,"description":"Unauthorized","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"data":"\u003cstring>","error_code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"31c426e3-01b5-4538-ab24-6142089d1223":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"string","isRequired":true,"uniqueKey":"data","typeLabel":"string"},"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"}},"required":["success","data"],"additionalProperties":false,"description":"Forbidden","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"data":"\u003cstring>","error_code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"dbc10dc5-8309-428e-9ce0-5d67b36ddce8":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"string","isRequired":true,"uniqueKey":"data","typeLabel":"string"},"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"}},"required":["success","data"],"additionalProperties":false,"description":"Not Found","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"data":"\u003cstring>","error_code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"10da0cca-91c2-4143-a41b-7dacf3d6637f":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"string","isRequired":true,"uniqueKey":"data","typeLabel":"string"},"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"}},"required":["success","data"],"additionalProperties":false,"description":"Internal Server Error","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"data":"\u003cstring>","error_code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"21ceafb8-ac94-423c-ad24-9244a58665ba":{"url":"https://b2b-api.dev-riseworks.io","description":"Development"},"2eb76bbb-f074-45d8-a59f-248d97e817a2":{"url":"https://b2b-api.staging-riseworks.io","description":"Staging"},"0d0671da-1b56-4fe6-8ee7-36a4fdaf8164":{"url":"https://b2b-api.riseworks.io","description":"Production"}}},"originalFileLocation":"openapi/openapi-v1.yaml"},"subdomain":"rise-067e2e54","siteName":"Rise API","title":"Prepare instant payment (V1 Legacy) - Rise API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T17:28:51.530Z","originalFileLocation":"api-reference-v1/payments/prepare-instant-payment-v1-legacy.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=\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rise API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_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/rise-067e2e54/b2iWOqZmzIHdD8oP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Prepare instant payment (V1 Legacy) - Rise API\">\u003cmeta data-mint-head property=\"og:description\" content=\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rise API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rise-067e2e54.mintlify.site/_mintlify/api/og/v2?division=Payments\u0026amp;title=Prepare+instant+payment+%28V1+Legacy%29\u0026amp;description=V1-compatible+endpoint+to+prepare+a+single+pay-now+payment+for+signing.+Returns+EIP-712+typed+data%2C+plus+a+non-blocking+%60duplicates%60+warning+when+a+similar+paym\u0026amp;theme=4bc0e62bdceeecedb98d5f94\u0026amp;signature=1e9131e0254c3172eb521dc5b514ae2eab960745d956cfa4cb8659b06ea17df8\">\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=\"Prepare instant payment (V1 Legacy) - Rise API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rise-067e2e54.mintlify.site/_mintlify/api/og/v2?division=Payments\u0026amp;title=Prepare+instant+payment+%28V1+Legacy%29\u0026amp;description=V1-compatible+endpoint+to+prepare+a+single+pay-now+payment+for+signing.+Returns+EIP-712+typed+data%2C+plus+a+non-blocking+%60duplicates%60+warning+when+a+similar+paym\u0026amp;theme=4bc0e62bdceeecedb98d5f94\u0026amp;signature=1e9131e0254c3172eb521dc5b514ae2eab960745d956cfa4cb8659b06ea17df8\">\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/rise-067e2e54/b2iWOqZmzIHdD8oP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rise API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5e59ec\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference-v1/payments/prepare-instant-payment-v1-legacy.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.riseworks.io/#organization\",\"name\":\"Rise API\",\"url\":\"https://docs.riseworks.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.prod.website-files.com/624f0c4263953ffe82f4e446/68092904f1a7fae9edc78b9b_RiseLogo.webp\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.riseworks.io#website\",\"name\":\"Rise API\",\"url\":\"https://docs.riseworks.io\",\"publisher\":{\"@id\":\"https://docs.riseworks.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy#webpage\",\"url\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy\",\"name\":\"Prepare instant payment (V1 Legacy)\",\"description\":\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.\",\"dateModified\":\"2026-10-08T17:28:51.530Z\",\"isPartOf\":{\"@id\":\"https://docs.riseworks.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Rise API\",\"item\":\"https://docs.riseworks.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Prepare instant payment (V1 Legacy)\",\"item\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy#apireference\",\"headline\":\"Prepare instant payment (V1 Legacy)\",\"name\":\"Prepare instant payment (V1 Legacy)\",\"description\":\"V1-compatible endpoint to prepare a single pay-now payment for signing. Returns EIP-712 typed data, plus a non-blocking duplicates warning when a similar payment (same payee/amount) exists in the lookback window.\",\"url\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy\",\"mainEntityOfPage\":{\"@id\":\"https://docs.riseworks.io/api-reference-v1/payments/prepare-instant-payment-v1-legacy#webpage\"},\"dateModified\":\"2026-10-08T17:28:51.530Z\",\"publisher\":{\"@id\":\"https://docs.riseworks.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.riseworks.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rise API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Rise API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference-v1/payments/prepare-instant-payment-v1-legacy.md","siteName":"Rise API","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Core Concepts","pages":[{"title":"Core Concepts","href":"/concepts/wallets"}]},{"tab":"Integration Guides","pages":[{"title":"Integration Guides","href":"/guides/web3-integration"}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks/getting-started/overview"}]},{"tab":"V1 Legacy","pages":[{"title":"V1 Legacy","href":"/v1-legacy/overview"}]},{"tab":"V1 Legacy API Reference","groups":[{"group":"Authentication","pages":[{"title":"Get SIWE (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/auth/api/siwe","href":"/api-reference-v1/auth/get-siwe-v1-legacy"},{"title":"Verify SIWE (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/auth/api/siwe","description":"V1-compatible endpoint to verify SIWE signature. Routes to V2 if user is migrated.","href":"/api-reference-v1/auth/verify-siwe-v1-legacy"}]},{"group":"Payments","pages":[{"title":"Prepare instant payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml PUT /v1/payments/pay","href":"/api-reference-v1/payments/prepare-instant-payment-v1-legacy"},{"title":"Execute instant payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/payments/pay","description":"V1-compatible endpoint to broadcast a previously-signed single pay-now payment. Duplicates are rejected (HTTP 409) on two independent keys: the salt-derived on-chain id (paying team account, payee, amount, salt) and, when provided, external_id (unique per payer).","href":"/api-reference-v1/payments/execute-instant-payment-v1-legacy"},{"title":"Prepare batch payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml PUT /v1/payments/batch-pay","href":"/api-reference-v1/payments/prepare-batch-payment-v1-legacy"},{"title":"Execute batch payment (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/payments/batch-pay","href":"/api-reference-v1/payments/execute-batch-payment-v1-legacy"},{"title":"Create batch payment intents (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/payments/batch-pay/intents","href":"/api-reference-v1/payments/create-batch-payment-intents-v1-legacy"},{"title":"List payments (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/payments","href":"/api-reference-v1/payments/list-payments-v1-legacy"}]},{"group":"Teams","pages":[{"title":"List teams (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/teams","href":"/api-reference-v1/teams/list-teams-v1-legacy"},{"title":"List team talent (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/teams/{teamId}/talent","href":"/api-reference-v1/teams/list-team-talent-v1-legacy"},{"title":"Get team talent (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/teams/{teamId}/talent/{talentId}","href":"/api-reference-v1/teams/get-team-talent-v1-legacy"},{"title":"Terminate team talent (V1 Legacy)","openapi":"openapi/openapi-v1.yaml DELETE /v1/teams/{teamId}/talent/{talentId}","href":"/api-reference-v1/teams/terminate-team-talent-v1-legacy"}]},{"group":"RiseID \u0026 Balance","pages":[{"title":"Get RiseID balance (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/riseid/{rise_id}/balance","href":"/api-reference-v1/riseid/get-riseid-balance-v1-legacy"}]},{"group":"Invites","pages":[{"title":"List invites (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/invites","href":"/api-reference-v1/invites/list-invites-v1-legacy"},{"title":"Send invites (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/invites","href":"/api-reference-v1/invites/send-invites-v1-legacy"},{"title":"Send warmed invites (V1 Legacy)","openapi":"openapi/openapi-v1.yaml POST /v1/invites/warmed","href":"/api-reference-v1/invites/send-warmed-invites-v1-legacy"}]},{"group":"Mapping","pages":[{"title":"Map V1 ids to V2 ids (V1 Legacy)","openapi":"openapi/openapi-v1.yaml GET /v1/mapping","href":"/api-reference-v1/mapping/map-v1-ids-to-v2-ids-v1-legacy"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/authentication/get-siwe"}]},{"tab":"Institutional API Reference","hidden":true,"pages":[{"title":"Institutional API Reference","href":"/api-reference/bill-pay/list-submitted-bill-pay-payments-with-their-business-status"}]}]},"basePath":"","title":"Prepare instant payment (V1 Legacy) - Rise API","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}