Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.
When you integrate via the API, every request reaches Ripio from your servers. Ripio does not see the end user’s own network or device, so it cannot tell two customers on the same phone apart, or notice that an operation comes from somewhere unusual for that customer.Three optional headers fill that gap. You send them with the requests your customers trigger, and Ripio records them against the customer for traceability and fraud prevention.
Header
What to send
Limit
X-Ripio-User-Ip
The public IP address of the end user’s device, IPv4 or IPv6
45 characters
X-Ripio-User-Agent
The User-Agent of the end user’s browser or app
500 characters, longer values are truncated
X-Ripio-User-Device-Id
A stable identifier of the end user’s device, as your app defines it
200 characters, longer values are truncated
The headers are optional. A request without them works exactly the same: nothing is rejected, and nothing about the customer’s experience changes. Sending them is recommended, because it gives Ripio’s risk checks the information they would otherwise not have.
Send the end user’s values, never your server’s
This is the one thing to get right. The values describe the person operating, so they have to come from their device:
Capture them on your frontend — the browser or app the customer is using.
Forward them to your backend with the customer’s request.
Send them to Ripio in these headers when your backend calls the API.
Do not fill them from your own server: its IP address, the user agent of your HTTP client, or a fixed identifier would make every customer look like the same machine — a datacenter — and turn the signal into noise. If you cannot get a value from the customer’s device, leave that header out. Each header is independent, so sending only the ones you have is fine.
Ripio never uses the address your request comes from as the customer’s IP: for an API integration, that address is your infrastructure. X-Ripio-User-Ip is the only way the customer’s IP reaches Ripio.
The values are declared by you: Ripio records them as you send them, as the context of your customer’s request. Send a valid IPv4 or IPv6 address in X-Ripio-User-Ip; an invalid one does not fail the request, but none of the three values of that request is recorded.
Example
POST /api/v1/onramp/ HTTP/1.1Host: skala.ripio.comAuthorization: Bearer <access_token>Content-Type: application/jsonX-Ripio-User-Ip: 203.0.113.24X-Ripio-User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1X-Ripio-User-Device-Id: 8d3f2c1a-6b7e-4f9a-a1d2-3c4b5e6f7a8b{ "customerId": "8142b065-79c4-4f48-9e33-11b17bc658d4", "quoteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "depositAddress": "0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32", "externalRef": "e6c4f1ec-899f-43b5-8479-c2529e3f9c70"}
Where they are recorded
The headers can be sent on any request, but they are recorded on the actions a customer takes — the ones where knowing who is behind the request matters:
They are recorded only when the request succeeds: a rejected request leaves no record. On any other endpoint the headers are accepted and ignored, so it is safe to attach them to every call your backend makes on a customer’s behalf.
Widget integrations
Partners on the Ramps widget do not need any of this: the widget captures the end user’s context itself and sends it with every operation.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ripio B2B API","description":"Ripio B2B APIs for crypto infrastructure and local stablecoins (wFiat) in Latin America: Crypto as a Service and the on/off-ramp Ramps API.","colors":{"primary":"#7908FF","light":"#7908FF","dark":"#7908FF"},"logo":{"light":"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_black.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=bdf337e5acb2526c20ade218091c4203","dark":"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_white.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=a68156b523e110deae3eaeb2feac1493"},"favicon":"https://mintcdn.com/ripio-9dfd4837/Z0ROxzVvVQCC2WDt/favicon.png?fit=max\u0026auto=format\u0026n=Z0ROxzVvVQCC2WDt\u0026q=85\u0026s=3763d7144291f35d0088536ef1aae78a","appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Register","href":"https://platform.ripio.com/register"}},"footer":{"socials":{"x":"https://x.com/ripiohq","instagram":"https://www.instagram.com/ripioapp","youtube":"https://www.youtube.com/Ripiotv","telegram":"https://t.me/+J7H4QmPlNIc2NDAx","linkedin":"https://ar.linkedin.com/company/ripio"}},"seo":{"organization":{"name":"Ripio","url":"https://www.ripio.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ripio-9dfd4837","hasAudioNarration":false,"actualSubdomain":"ripio-9dfd4837","customDomains":["docs.ripio.com"],"gitSource":{"type":"github","owner":"ripio","repo":"b2b-docs-mintlify","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcb7c5297f86129b6d8922","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Integration","count":167},{"language":"default","tag":"API Reference","count":151},{"language":"default","tag":"Ramps","count":111},{"language":"default","tag":"Crypto as a Service","count":95},{"language":"default","tag":"Overview","count":28},{"language":"default","tag":"Widget integration","count":16},{"language":"default","tag":"Crypto Widget","count":14},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"User flows","count":12},{"language":"default","tag":"Onchain Deposits \u0026 Withdrawals","count":11}]},"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ramps-api/guides/end-user-context","slug":"/ramps-api/guides/end-user-context","pageMetadata":{"title":"Forwarding end-user context","description":"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.","keywords":["X-Ripio-User-Ip","X-Ripio-User-Agent","X-Ripio-User-Device-Id","end user ip","device id","fraud prevention","headers"],"href":"/ramps-api/guides/end-user-context"},"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: \"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\"\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`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When you integrate via the API, every request reaches Ripio from `,_jsx(_components.strong,{children:`your`}),` servers. Ripio does not see the end user’s own network or device, so it cannot tell two customers on the same phone apart, or notice that an operation comes from somewhere unusual for that customer.`]}),`\n`,_jsxs(_components.p,{children:[`Three optional headers fill that gap. You send them with the requests your customers trigger, and Ripio records them against the customer for `,_jsx(_components.strong,{children:`traceability`}),` and `,_jsx(_components.strong,{children:`fraud prevention`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`What to send`}),_jsx(_components.th,{children:`Limit`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Ripio-User-Ip`})}),_jsx(_components.td,{children:`The public IP address of the end user’s device, IPv4 or IPv6`}),_jsx(_components.td,{children:`45 characters`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Ripio-User-Agent`})}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`User-Agent`}),` of the end user’s browser or app`]}),_jsx(_components.td,{children:`500 characters, longer values are truncated`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Ripio-User-Device-Id`})}),_jsx(_components.td,{children:`A stable identifier of the end user’s device, as your app defines it`}),_jsx(_components.td,{children:`200 characters, longer values are truncated`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The headers are `,_jsx(_components.strong,{children:`optional`}),`. A request without them works exactly the same: nothing is rejected, and nothing about the customer’s experience changes. Sending them is recommended, because it gives Ripio’s risk checks the information they would otherwise not have.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`send-the-end-user’s-values-never-your-server’s`,children:`Send the end user’s values, never your server’s`}),`\n`,_jsxs(_components.p,{children:[`This is the one thing to get right. The values describe `,_jsx(_components.strong,{children:`the person operating`}),`, so they have to come from their device:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Capture them on your frontend`}),` — the browser or app the customer is using.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Forward them to your backend`}),` with the customer’s request.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Send them to Ripio`}),` in these headers when your backend calls the API.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Do `,_jsx(_components.strong,{children:`not`}),` fill them from your own server: its IP address, the user agent of your HTTP client, or a fixed identifier would make every customer look like the same machine — a datacenter — and turn the signal into noise. If you cannot get a value from the customer’s device, leave that header out. Each header is independent, so sending only the ones you have is fine.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Ripio never uses the address your request comes from as the customer’s IP: for an API integration, that address is your infrastructure. `,_jsx(_components.code,{children:`X-Ripio-User-Ip`}),` is the only way the customer’s IP reaches Ripio.`]})}),`\n`,_jsxs(_components.p,{children:[`The values are `,_jsx(_components.strong,{children:`declared by you`}),`: Ripio records them as you send them, as the context of your customer’s request. Send a valid IPv4 or IPv6 address in `,_jsx(_components.code,{children:`X-Ripio-User-Ip`}),`; an invalid one does not fail the request, but none of the three values of that request is recorded.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /api/v1/onramp/ `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Host`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` skala.ripio.com`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer \u003caccess_token>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Ripio-User-Ip`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 203.0.113.24`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Ripio-User-Agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`X-Ripio-User-Device-Id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 8d3f2c1a-6b7e-4f9a-a1d2-3c4b5e6f7a8b`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customerId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"8142b065-79c4-4f48-9e33-11b17bc658d4\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quoteId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3fa85f64-5717-4562-b3fc-2c963f66afa6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"depositAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x4e88BBeFF059BDDF5BF90ee0816E86eDf4214b32\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"externalRef\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"e6c4f1ec-899f-43b5-8479-c2529e3f9c70\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`where-they-are-recorded`,children:`Where they are recorded`}),`\n`,_jsx(_components.p,{children:`The headers can be sent on any request, but they are recorded on the actions a customer takes — the ones where knowing who is behind the request matters:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Endpoint`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create an on-ramp order or session`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ramps-api/on-ramp/create-on-ramp-order`,children:_jsx(_components.code,{children:`POST /api/v1/onramp/`})}),` · `,_jsx(_components.a,{href:`/ramps-api/on-ramp/create-on-ramp-session`,children:_jsx(_components.code,{children:`POST /api/v1/onrampSession/`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create an off-ramp order or session`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ramps-api/off-ramp/create-off-ramp-order`,children:_jsx(_components.code,{children:`POST /api/v1/offramp/`})}),` · `,_jsx(_components.a,{href:`/ramps-api/off-ramp/create-off-ramp-session`,children:_jsx(_components.code,{children:`POST /api/v1/offrampSession/`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Submit KYC information`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/ramps-api/kyc/submit-kyc-information`,children:_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/kyc/`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Validate a KYC one-time code`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ramps-api/kyc/validate-kyc-otp`,children:_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/kyc/otp/validate/`})}),` · `,_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/otp/`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Accept the Terms \u0026 Conditions`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/ramps-api/customers/accept-terms`,children:_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/acceptTerms/`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create a deposit or destination account`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/ramps-api/customers/create-deposit-account`,children:_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/fiatAccount/`})}),` · `,_jsx(_components.a,{href:`/ramps-api/fiat-accounts/create-fiat-account`,children:_jsx(_components.code,{children:`POST /api/v1/fiatAccounts/`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Request a refund`}),_jsxs(_components.td,{children:[`The four customer-scoped refund endpoints — see `,_jsx(_components.a,{href:`/ramps-api/refunds/overview`,children:`Refunds`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Submit the investor profile (Brazilian accounts)`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/ramps-api/investor-profile/submit-investor-profile`,children:_jsx(_components.code,{children:`POST /api/v1/customers/{customerId}/investorProfile/`})})})]})]})]}),`\n`,_jsx(_components.p,{children:`They are recorded only when the request succeeds: a rejected request leaves no record. On any other endpoint the headers are accepted and ignored, so it is safe to attach them to every call your backend makes on a customer’s behalf.`}),`\n`,_jsx(Heading,{level:`2`,id:`widget-integrations`,children:`Widget integrations`}),`\n`,_jsxs(_components.p,{children:[`Partners on the `,_jsx(_components.a,{href:`/ramps-api/widget/overview`,children:`Ramps widget`}),` do not need any of this: the widget captures the end user’s context itself and sends it with every operation.`]})]})}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":"Forwarding end-user context","description":"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.","keywords":["X-Ripio-User-Ip","X-Ripio-User-Agent","X-Ripio-User-Device-Id","end user ip","device id","fraud prevention","headers"],"href":"/ramps-api/guides/end-user-context"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Send the end user’s values, never your server’s","slug":"send-the-end-user’s-values-never-your-server’s","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]},{"title":"Where they are recorded","slug":"where-they-are-recorded","depth":2,"children":[]},{"title":"Widget integrations","slug":"widget-integrations","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ripio-9dfd4837/e90081465672ce62/seo-jsonld.js"],"subdomain":"ripio-9dfd4837","siteName":"Ripio B2B API","title":"Forwarding end-user context - Ripio B2B API","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T20:23:43.752Z","originalFileLocation":"ramps-api/guides/end-user-context.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=\"dark\"}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=\"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ripio B2B 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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Forwarding end-user context - Ripio B2B API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ripio B2B API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ripio.com/ramps-api/guides/end-user-context\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ripio-9dfd4837.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Forwarding+end-user+context\u0026amp;description=Optional+headers+that+tell+Ripio+the+IP+address%2C+user+agent+and+device+of+the+end+user+behind+each+request%2C+for+traceability+and+fraud+prevention.\u0026amp;theme=78128f9583fb0593c455d352\u0026amp;signature=9e658f43925c22dc971cf714cbb7c40ea2ce43ef40de9da1bd8c266b6302019a\">\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=\"Forwarding end-user context - Ripio B2B API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ripio-9dfd4837.mintlify.site/_mintlify/api/og/v2?division=Overview\u0026amp;title=Forwarding+end-user+context\u0026amp;description=Optional+headers+that+tell+Ripio+the+IP+address%2C+user+agent+and+device+of+the+end+user+behind+each+request%2C+for+traceability+and+fraud+prevention.\u0026amp;theme=78128f9583fb0593c455d352\u0026amp;signature=9e658f43925c22dc971cf714cbb7c40ea2ce43ef40de9da1bd8c266b6302019a\">\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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ripio B2B API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7908FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ripio.com/ramps-api/guides/end-user-context\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ramps-api/guides/end-user-context.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ripio.com/#organization\",\"name\":\"Ripio\",\"url\":\"https://www.ripio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_black.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=bdf337e5acb2526c20ade218091c4203\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ripio.com#website\",\"name\":\"Ripio B2B API\",\"url\":\"https://docs.ripio.com\",\"publisher\":{\"@id\":\"https://www.ripio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ripio.com/ramps-api/guides/end-user-context#webpage\",\"url\":\"https://docs.ripio.com/ramps-api/guides/end-user-context\",\"name\":\"Forwarding end-user context\",\"description\":\"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\",\"dateModified\":\"2026-11-17T20:23:43.752Z\",\"isPartOf\":{\"@id\":\"https://docs.ripio.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ripio.com/ramps-api/guides/end-user-context#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ripio.com/ramps-api/guides/end-user-context#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Integration\",\"item\":\"https://docs.ripio.com/ramps-api/kyc/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Overview\",\"item\":\"https://docs.ripio.com/ramps-api/kyc/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Forwarding end-user context\",\"item\":\"https://docs.ripio.com/ramps-api/guides/end-user-context\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ripio.com/ramps-api/guides/end-user-context#article\",\"headline\":\"Forwarding end-user context\",\"name\":\"Forwarding end-user context\",\"description\":\"Optional headers that tell Ripio the IP address, user agent and device of the end user behind each request, for traceability and fraud prevention.\",\"url\":\"https://docs.ripio.com/ramps-api/guides/end-user-context\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ripio.com/ramps-api/guides/end-user-context#webpage\"},\"dateModified\":\"2026-11-17T20:23:43.752Z\",\"keywords\":\"X-Ripio-User-Ip, X-Ripio-User-Agent, X-Ripio-User-Device-Id, end user ip, device id, fraud prevention, headers\",\"publisher\":{\"@id\":\"https://www.ripio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ripio.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ripio B2B API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ripio\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ramps-api/guides/end-user-context.md","siteName":"Ripio B2B API","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":""}]},{"tab":"Crypto as a Service","pages":[{"title":"Crypto as a Service","href":"/crypto-as-a-service/overview/introduction"}]},{"tab":"Ramps","groups":[{"group":"Overview","pages":[{"title":"Ripio Ramps API: On-Ramp \u0026 Off-Ramp Integration for Partners","sidebarTitle":"Introduction","href":"/ramps-api/overview/introduction"},{"title":"Choose your integration","href":"/ramps-api/overview/choose-your-integration"},{"group":"Countries \u0026 payment methods","pages":[{"title":"Countries \u0026 payment methods","sidebarTitle":"Overview","href":"/ramps-api/overview/countries/overview"},{"title":"Argentina","href":"/ramps-api/overview/countries/argentina"},{"title":"Mexico","href":"/ramps-api/overview/countries/mexico"},{"title":"Colombia","href":"/ramps-api/overview/countries/colombia"},{"title":"Brazil","href":"/ramps-api/overview/countries/brazil"}]}]},{"group":"Widget integration","pages":[{"title":"Widget integration","sidebarTitle":"Overview","href":"/ramps-api/widget/overview"},{"group":"Get started","pages":[{"title":"Authentication","href":"/ramps-api/widget/get-started/authentication"},{"title":"Launch the widget","href":"/ramps-api/widget/get-started/launch"},{"title":"Returning to your app","href":"/ramps-api/widget/get-started/returning-to-your-app"}]},{"group":"User flows","pages":[{"title":"Sign-in and terms","href":"/ramps-api/widget/flows/identity-and-terms"},{"title":"Identity verification in the widget","href":"/ramps-api/widget/flows/kyc"},{"title":"Investor profile (Brazil)","href":"/ramps-api/widget/flows/investor-profile"},{"title":"Travel Rule (Mexico)","href":"/ramps-api/widget/flows/travel-rule"},{"title":"Buying crypto (on-ramp)","href":"/ramps-api/widget/flows/on-ramp"},{"title":"Selling crypto (off-ramp)","href":"/ramps-api/widget/flows/off-ramp"},{"title":"History and refunds","href":"/ramps-api/widget/flows/history-and-refunds"},{"title":"Recovering a rejected payout","href":"/ramps-api/widget/flows/order-recovery"},{"title":"Emails Ripio sends your users","href":"/ramps-api/widget/flows/emails"}]},{"group":"Configuration","pages":[{"title":"Partner settings","href":"/ramps-api/widget/configuration/partner-settings"},{"title":"Theming","href":"/ramps-api/widget/configuration/theming"}]},{"title":"Troubleshooting and support","href":"/ramps-api/widget/troubleshooting"}]},{"group":"API Integration","pages":[{"group":"Overview","pages":[{"group":"Identity verification (KYC)","pages":[{"title":"Overview \u0026 which model to use","sidebarTitle":"Overview","href":"/ramps-api/kyc/overview"},{"title":"Ripio-hosted KYC (redirect)","sidebarTitle":"Ripio-hosted KYC (redirect)","href":"/ramps-api/kyc/kyc-with-ripio"},{"title":"Partner-submitted KYC (API)","sidebarTitle":"Partner-submitted KYC (API)","href":"/ramps-api/kyc/kyc-via-api-overview"},{"title":"KYC fields by country","sidebarTitle":"KYC fields by country","href":"/ramps-api/kyc/kyc-fields-by-country"},{"title":"Reusable KYC (Sumsub share token)","sidebarTitle":"Reusable KYC (share token)","href":"/ramps-api/kyc/reusable-kyc"}]},{"title":"On-Ramp integration","href":"/ramps-api/guides/on-ramp-integration"},{"title":"Off-Ramp integration","href":"/ramps-api/guides/off-ramp-integration"},{"title":"QR payments integration","description":"Step-by-step walkthrough to let your users pay a merchant's QR code with crypto using Sell and Pay, in Argentina and Colombia.","href":"/ramps-api/guides/qr-payments-integration"},{"title":"Forwarding end-user context","href":"/ramps-api/guides/end-user-context"}]},{"group":"API Reference","pages":[{"group":"Authentication","pages":[{"openapi":"ramps-api/openapi.json POST /oauth2/token/","title":"Acquire Access Token","description":"Every call to the API has to be authenticated with an OAuth2 Token. In order to request this token, you will need to have sandbox or production API Keys (`client_id` and `client_secret`) that will allow to negotiate an ephemeral access token.\n\nTo generate the access token, you should call this endpoint providing the header `Authorization` with the following schema: `Basic CREDENTIAL` where `CREDENTIAL` should be specified as a string with the format`client_id:client_secret` encoded in Base64.","href":"/ramps-api/authentication/acquire-access-token"}]},{"group":"Errors","pages":[{"title":"Error Codes","href":"/ramps-api/errors/error-codes"}]},{"group":"Customers","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/customers/","title":"Create Customer","href":"/ramps-api/customers/create-customer"},{"openapi":"ramps-api/openapi.json PUT /api/v1/customers/{customerId}/","title":"Update Customer","href":"/ramps-api/customers/update-customer"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/fiatAccount/","title":"Create Deposit Account","href":"/ramps-api/customers/create-deposit-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/acceptTerms/","title":"Accept Terms and Conditions","href":"/ramps-api/customers/accept-terms"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/deactivate/","title":"Deactivate Customer","href":"/ramps-api/customers/deactivate-customer"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/reactivate/","title":"Reactivate Customer","href":"/ramps-api/customers/reactivate-customer"}]},{"group":"Terms and Conditions","pages":[{"title":"Terms and Conditions","href":"/ramps-api/terms-and-conditions/introduction"},{"openapi":"ramps-api/openapi.json GET /api/v1/termsAndConditions/","title":"Get Terms and Conditions","href":"/ramps-api/terms-and-conditions/get-terms-and-conditions"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/termsAcceptance/","title":"Get Terms Acceptance Status","href":"/ramps-api/terms-and-conditions/get-terms-acceptance-status"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/termsLink/","title":"Create Terms Acceptance Link","href":"/ramps-api/terms-and-conditions/create-terms-link"}]},{"group":"Investor Profile (Brazil)","pages":[{"title":"Investor Profile (Brazil)","href":"/ramps-api/investor-profile/introduction"},{"openapi":"ramps-api/openapi.json GET /api/v1/investorProfile/questionnaire/","title":"Get Investor Questionnaire","href":"/ramps-api/investor-profile/get-investor-questionnaire"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/investorProfile/","title":"Get Investor Profile Status","href":"/ramps-api/investor-profile/get-investor-profile-status"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/investorProfile/","title":"Submit Investor Profile","href":"/ramps-api/investor-profile/submit-investor-profile"}]},{"group":"Travel Rule (Mexico)","pages":[{"title":"Travel Rule (Mexico)","href":"/ramps-api/travel-rule/introduction"}]},{"group":"KYC","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/kycRequirements/","title":"Retrieve KYC Requirements","href":"/ramps-api/kyc/retrieve-kyc-requirements"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/start/","title":"Start KYC","href":"/ramps-api/kyc/start-kyc"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/","title":"Submit KYC Information","href":"/ramps-api/kyc/submit-kyc-information"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/otp/resend/","title":"Resend KYC OTP","href":"/ramps-api/kyc/resend-kyc-otp"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/otp/validate/","title":"Validate KYC OTP","href":"/ramps-api/kyc/validate-kyc-otp"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/kycSubmissions/","title":"Retrieve Latest KYC Submission","href":"/ramps-api/kyc/retrieve-kyc-submission"}]},{"group":"Fiat Accounts","pages":[{"title":"Fiat account lifecycle","href":"/ramps-api/fiat-accounts/lifecycle"},{"openapi":"ramps-api/openapi.json GET /api/v1/fiatAccounts/","title":"List Fiat Accounts","href":"/ramps-api/fiat-accounts/list-fiat-accounts"},{"openapi":"ramps-api/openapi.json POST /api/v1/fiatAccounts/","title":"Create Fiat Account","href":"/ramps-api/fiat-accounts/create-fiat-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/fiatAccounts/{fiatAccountId}/confirm/","title":"Confirm Fiat Account","href":"/ramps-api/fiat-accounts/confirm-fiat-account"},{"openapi":"ramps-api/openapi.json GET /api/v1/fiatAccounts/requirements/","title":"Retrieve Fiat Account Requirements","href":"/ramps-api/fiat-accounts/retrieve-fiat-account-requirements"},{"openapi":"ramps-api/openapi.json GET /api/v1/banks/","title":"List Bank Codes","href":"/ramps-api/fiat-accounts/list-banks"}]},{"group":"Quotes","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/quotes/","title":"Create Quote","href":"/ramps-api/quotes/create-quote"}]},{"group":"On-Ramp","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/onramp/","title":"List On-Ramp Orders","href":"/ramps-api/on-ramp/list-on-ramp-orders"},{"openapi":"ramps-api/openapi.json POST /api/v1/onramp/","title":"Create On-Ramp Order","href":"/ramps-api/on-ramp/create-on-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/onramp/{orderId}/","title":"Retrieve an On-Ramp Order","href":"/ramps-api/on-ramp/retrieve-an-on-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/onrampSession/","title":"List On-Ramp Sessions","href":"/ramps-api/on-ramp/list-on-ramp-sessions"},{"openapi":"ramps-api/openapi.json POST /api/v1/onrampSession/","title":"Create On-Ramp Session","href":"/ramps-api/on-ramp/create-on-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/onrampSession/{sessionId}/","title":"Retrieve an On-Ramp Session","href":"/ramps-api/on-ramp/retrieve-an-on-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/onrampSession/","title":"Retrieve a Customer's On-Ramp Session","href":"/ramps-api/on-ramp/retrieve-a-customer-on-ramp-session"}]},{"group":"Off-Ramp","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/offramp/","title":"List Off-Ramp Orders","href":"/ramps-api/off-ramp/list-off-ramp-orders"},{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/","title":"Create Off-Ramp Order","href":"/ramps-api/off-ramp/create-off-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/offramp/{orderId}/","title":"Retrieve an Off-Ramp Order","href":"/ramps-api/off-ramp/retrieve-an-off-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/offrampSession/","title":"List Off-Ramp Sessions","href":"/ramps-api/off-ramp/list-off-ramp-sessions"},{"openapi":"ramps-api/openapi.json POST /api/v1/offrampSession/","title":"Create Off-Ramp Session","href":"/ramps-api/off-ramp/create-off-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/offrampSession/{sessionId}/","title":"Retrieve an Off-Ramp Session","href":"/ramps-api/off-ramp/retrieve-an-off-ramp-session"},{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/{orderId}/changeFiatAccount/","title":"Change Fiat Account and Reprocess","href":"/ramps-api/off-ramp/change-fiat-account"}]},{"group":"Refunds","pages":[{"title":"Refunds","sidebarTitle":"Overview","href":"/ramps-api/refunds/overview"},{"group":"Fiat Refunds","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/","title":"Request a Fiat Refund","href":"/ramps-api/refunds/request-fiat-refund"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/refundableDeposits/","title":"List Refundable Deposits","href":"/ramps-api/refunds/list-refundable-deposits"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/refundableDeposits/{depositUuid}/refund/","title":"Refund a Deposit","href":"/ramps-api/refunds/refund-deposit"}]},{"group":"Crypto Refunds","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/{orderId}/refund/","title":"Request a Crypto Refund","href":"/ramps-api/refunds/request-crypto-refund"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/transactions/offramp/{orderId}/refund/","title":"Request a Customer's Crypto Refund","href":"/ramps-api/refunds/request-customer-crypto-refund"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/refundableCryptoDeposits/","title":"List Refundable Crypto Deposits","href":"/ramps-api/refunds/list-refundable-crypto-deposits"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/refundableCryptoDeposits/{depositId}/refund/","title":"Refund a Crypto Deposit","href":"/ramps-api/refunds/refund-crypto-deposit"}]}]},{"group":"Sell and Pay","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/fiatAccounts/","title":"Create fiat account for sell and pay","href":"/ramps-api/sell-and-pay/create-fiat-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/","title":"Create Sell and Pay transaction","href":"/ramps-api/sell-and-pay/create-sell-and-pay"},{"openapi":"ramps-api/openapi.json PUT /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Update Sell and Pay transaction","href":"/ramps-api/sell-and-pay/update-sell-and-pay"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/{sell_and_pay_id}/execute/","title":"Execute Sell and Pay transaction","href":"/ramps-api/sell-and-pay/execute-sell-and-pay"},{"openapi":"ramps-api/openapi.json GET /api/v1/sellAndPays/","title":"List Sell and Pay transactions","href":"/ramps-api/sell-and-pay/list-sell-and-pay"},{"openapi":"ramps-api/openapi.json GET /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Retrieve Sell and Pay transaction","href":"/ramps-api/sell-and-pay/retrieve-sell-and-pay"},{"openapi":"ramps-api/openapi.json DELETE /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Delete Sell and Pay transaction","href":"/ramps-api/sell-and-pay/delete-sell-and-pay"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/validateQrCode/","title":"Validate QR Code","href":"/ramps-api/sell-and-pay/validate-qr-code"}]},{"group":"Transactions","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/transactions/","title":"List All Orders (On-Ramp \u0026 Off-Ramp)","href":"/ramps-api/transactions/list-all-orders-on-ramp-\u0026-off-ramp"},{"openapi":"ramps-api/openapi.json GET /api/v1/transactions/{orderId}/","title":"Retrieve an Order (On-Ramp or Off-Ramp)","href":"/ramps-api/transactions/retrieve-an-order"},{"group":"Customer Transactions","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/transactions/onramp/","title":"List Customer's On-Ramp Transaction History","href":"/ramps-api/transactions/list-customer-onramp-transactions"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/transactions/offramp/","title":"List Customer's Off-Ramp Transaction History","href":"/ramps-api/transactions/list-customer-offramp-transactions"}]}]},{"group":"Networks","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/depositNetworks/","title":"Get Deposit Networks","href":"/ramps-api/networks/get-deposit-networks"},{"openapi":"ramps-api/openapi.json GET /api/v1/withdrawalNetworks/","title":"Get Withdrawal Networks","href":"/ramps-api/networks/get-withdrawal-networks"}]},{"group":"Rates","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/rates/","title":"Get Market Rates","href":"/ramps-api/rates/get-market-rates"}]},{"group":"Transaction Limits","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/transactionLimits/","title":"Get Transaction Limits","href":"/ramps-api/transaction-limits/get-transaction-limits"}]},{"group":"Sandbox","pages":[{"title":"KYC in sandbox","href":"/ramps-api/sandbox/kyc-in-sandbox"},{"openapi":"ramps-api/openapi.json POST /api/v1/simulateDeposit/","title":"Simulate Deposit for On-Ramp (Sandbox)","href":"/ramps-api/sandbox/simulate-deposit-for-on-ramp-sandbox"}]},{"group":"Support Tickets","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/supportTickets/","title":"Create Support Ticket","href":"/ramps-api/support-tickets/create-support-ticket"},{"openapi":"ramps-api/openapi.json GET /api/v1/supportTickets/{ticketId}/","title":"Retrieve Support Ticket","href":"/ramps-api/support-tickets/retrieve-support-ticket"}]},{"group":"Webhooks","pages":[{"group":"Introduction","pages":[{"title":"Webhooks Introduction","href":"/ramps-api/webhooks/introduction"}]},{"group":"On-Ramp Events","pages":[{"title":"On-Ramp Webhook Events","href":"/ramps-api/webhooks/on-ramp-events"}]},{"group":"Off-Ramp Events","pages":[{"title":"Off-Ramp Webhook Events","href":"/ramps-api/webhooks/off-ramp-events"}]},{"group":"Sell and Pay Events","pages":[{"title":"Sell and Pay Webhook Events","href":"/ramps-api/webhooks/sell-and-pay-events"}]},{"group":"KYC Events","pages":[{"title":"KYC Webhook Events","href":"/ramps-api/webhooks/kyc-events"}]},{"group":"Account Events","pages":[{"title":"Account Webhook Events","href":"/ramps-api/webhooks/account-events"}]},{"group":"Support Ticket Events","pages":[{"title":"Support Ticket Webhook Events","href":"/ramps-api/webhooks/support-ticket-events"}]}]}]}]}]},{"tab":"wFiat Stablecoins","pages":[{"title":"wFiat Stablecoins","href":"/wfiat/overview"}]}]},"basePath":"","title":"Forwarding end-user context - Ripio B2B API","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}