{"templateId":"markdown","versions":[{"version":"v0-beta","label":"Beta (v0)","link":"/products/native-api/docs/compliance/regulatory-agreements","default":true,"active":true,"folderId":"e4cb5a06"}],"sharedDataIds":{"sidebar":"sidebar-products/native-api/@v0-beta/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Regulatory Agreements","description":"Official Banxa API documentation – on-ramp and off-ramp transfers with identity verification and compliance.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"regulatory-agreements","__idx":0},"children":["Regulatory Agreements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partners integrating via the Banxa Native API control the full user experience, including the presentation of required legal agreements. Banxa does not surface these agreements on the partner's behalf. Failure to display required agreements before a user transacts is a compliance breach and may result in transaction failures or go-live being blocked."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-need-to-display","__idx":1},"children":["What you need to display"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Required agreements are additive — each layer below builds on the previous. Display all agreements that apply to your users' jurisdiction before they initiate their first transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layer-1--all-users-all-regions","__idx":2},"children":["Layer 1 — All users, all regions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every user transacting through the Banxa Native API must be shown and must accept:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://banxa.com/wp-content/uploads/2025/10/Customer-Terms-and-Conditions-16-October-2025-BANXA.pdf"},"children":["Banxa Terms & Conditions"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layer-2--users-transacting-in-the-united-states","__idx":3},"children":["Layer 2 — Users transacting in the United States"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to the above, US users must also be shown and accept:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://banxa.com/wp-content/uploads/2025/02/Privacy-and-Cookies-Policy-1-July-2024-Banxa.pdf"},"children":["Banxa Privacy Policy"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://banxa.com/wp-content/uploads/2025/02/Biometric-Privacy-Disclosure-and-Consent.pdf"},"children":["Banxa Biometric Privacy Disclosure"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://banxa.com/wp-content/uploads/2025/10/BNXA-USA-MTL-Inc-_-Website-Licenses-as-of-10.16.2025.pdf"},"children":["Banxa State Disclosures"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layer-3--us-users-in-specific-states","__idx":4},"children":["Layer 3 — US users in specific states"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users in the following states are processed through a licensed sub-processor and must also accept that sub-processor's agreements, in addition to all of the above."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"zerohash--tx-wa-wi-va","__idx":5},"children":["Zerohash — TX, WA, WI, VA"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.zerohash.com/page/terms-of-service"},"children":["Zero Hash Terms of Service"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.zerohash.com/page/us-licenses-and-disclosures"},"children":["Zero Hash US Licenses and Disclosures"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.zerohash.com/page/privacy-policy"},"children":["Zero Hash Privacy Policy"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"axnab--ga-mn-wa","__idx":6},"children":["Axnab — GA, MN, WA"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://axnab.com/wp-content/uploads/2025/10/Customer-Terms-and-Conditions-16-October-2025-AXNAB.pdf"},"children":["Axnab Terms & Conditions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://axnab.com/wp-content/uploads/2024/11/Biometric-Privacy-Disclosure-and-Consent.pdf"},"children":["Axnab Biometric Privacy Disclosure and Consent"]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Axnab does not require a separate privacy policy document at this layer."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Washington (WA)"]}," is processed through both Zerohash and Axnab. Users in WA must accept agreements from both sub-processors."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layer-4--us-users-paying-via-ach-bank-transfer","__idx":7},"children":["Layer 4 — US users paying via ACH bank transfer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to all of the above, US users completing an ACH transaction must also be shown and accept:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.bridge.xyz/legal/overview"},"children":["Bridge Terms of Service"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.bridge.xyz/legal/eea-privacy-policy/bridge-building-sp-zoo"},"children":["Bridge Privacy Policy"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"display-requirements","__idx":8},"children":["Display requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Agreements must be presented clearly before the user initiates their first transaction — not buried in a settings flow or footer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Acceptance must be captured explicitly (e.g. a checkbox with a visible link to each document)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Banxa's compliance team will review a screen recording of the acceptance flow before approving go-live."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-acknowledgement-field-layer-4--ach-only","__idx":9},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acknowledgement"]}," field (Layer 4 — ACH only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ACH transactions, acceptance is also captured at the API level via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acknowledgement"]}," field on the ramp creation endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When it is required:"]}," Banxa checks two conditions at ramp creation:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The payment method is ACH"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The user has not previously accepted the agreements"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If both conditions are true, the request must include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acknowledgement"]}," field. Omitting it returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," error."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After first acceptance, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signed_agreement_id"]}," is stored on the user's record and forwarded to Bridge. Subsequent ACH transactions by the same user do not require re-acceptance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-example","__idx":10},"children":["Request example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"identityReference\": \"user-abc123\",\n  \"source\": {\n    \"fiat\": {\n      \"id\": \"USD\",\n      \"method\": \"ach-bank-transfer\"\n    }\n  },\n  \"target\": {\n    \"crypto\": {\n      \"id\": \"USDT\",\n      \"blockchain\": \"ETH\",\n      \"walletAddress\": \"0xYourWalletAddress\"\n    }\n  },\n  \"fiatAmount\": \"200\",\n  \"acknowledgement\": {\n    \"agreedToTerms\": true,\n    \"agreedAt\": \"2026-05-04T10:00:00.000Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"error-when-acknowledgement-is-missing","__idx":11},"children":["Error when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acknowledgement"]}," is missing"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": 400,\n  \"code\": \"ACKNOWLEDGEMENT_REQUIRED\",\n  \"message\": \"Customer must accept agreements before proceeding with ACH payment.\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":12},"children":["Summary"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"User"},"children":["User"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Required agreements"},"children":["Required agreements"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["All users"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Banxa Terms & Conditions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US users"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["+ Banxa Privacy Policy, Biometric Privacy Disclosure, State Disclosures"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US users in TX, WI, VA"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["+ Zero Hash ToS, US Licenses & Disclosures, Privacy Policy"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US users in GA, MN"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["+ Axnab T&Cs, Axnab Biometric Privacy Disclosure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US users in WA"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["+ Zero Hash ToS, US Licenses & Disclosures, Zero Hash Privacy Policy, Axnab T&Cs, Axnab Biometric Privacy Disclosure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US users paying via ACH"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["All of the above (where applicable) + Bridge Terms of Service + Bridge Privacy Policy + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acknowledgement"]}," field"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Go-live requirement:"]}," Before going live with any US users, provide your Banxa contact with a screen recording showing where each required agreement is displayed and how acceptance is captured. For ACH specifically, production access will not be granted until this review is complete."]}]}]},"headings":[{"value":"Regulatory Agreements","id":"regulatory-agreements","depth":1},{"value":"What you need to display","id":"what-you-need-to-display","depth":2},{"value":"Layer 1 — All users, all regions","id":"layer-1--all-users-all-regions","depth":3},{"value":"Layer 2 — Users transacting in the United States","id":"layer-2--users-transacting-in-the-united-states","depth":3},{"value":"Layer 3 — US users in specific states","id":"layer-3--us-users-in-specific-states","depth":3},{"value":"Zerohash — TX, WA, WI, VA","id":"zerohash--tx-wa-wi-va","depth":4},{"value":"Axnab — GA, MN, WA","id":"axnab--ga-mn-wa","depth":4},{"value":"Layer 4 — US users paying via ACH bank transfer","id":"layer-4--us-users-paying-via-ach-bank-transfer","depth":3},{"value":"Display requirements","id":"display-requirements","depth":3},{"value":"The acknowledgement field (Layer 4 — ACH only)","id":"the-acknowledgement-field-layer-4--ach-only","depth":2},{"value":"Request example","id":"request-example","depth":3},{"value":"Error when acknowledgement is missing","id":"error-when-acknowledgement-is-missing","depth":3},{"value":"Summary","id":"summary","depth":2}],"frontmatter":{"title":"Regulatory Agreements","description":"Legal agreements partners must display to users before transacting through Banxa Native API.","seo":{"title":"Regulatory Agreements"}},"lastModified":"2026-05-19T23:30:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/native-api/docs/compliance/regulatory-agreements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}