# Gnosis Pay Documentation

## Docs

- [Get Access Token](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/auth/get-access-token.md): Verify a signed SIWE message. Returns both a short-lived access token and a longer-lived refresh token in the response body. The client is responsible for storing the refresh token securely.
- [Get Siwe message](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/auth/get-siwe-message.md): Retrieve the message that users need to Sign in with Ethereum (SIWE)
- [Logout](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/auth/logout.md): Invalidate the current session by revoking all refresh tokens in the token family. The client is responsible for deleting the refresh token from its storage.
- [Refresh Access Token](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/auth/refresh-access-token.md): Exchange a valid refresh token for a new access token and rotated refresh token. The refresh token must be sent in the request body.
- [Request Email Verification](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/auth/request-email-verification.md): Send a one-time password to the specified email address
- [Block Card](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/block-card.md): Blocks a card temporarily. A blocked card cannot be used for transactions. Use unblock to restore access. The card must belong to the authenticated user's cardholder.
- [Cancel Card](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/cancel-card.md): Cancels a card permanently. Once canceled, the card cannot be reactivated. A new card must be issued. The card must belong to the authenticated user's cardholder.
- [Create Virtual Card](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/create-virtual-card.md): Create a virtual card for the authenticated user. Virtual cards are issued instantly and can be used for online transactions. If the user does not yet have a cardholder, one is created automatically using the provided phone number (required for first card creation).
- [Get Card Daily Spending Limit](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/get-card-daily-spending-limit.md): Returns the daily spending limit configured on a card. `amount` is in the currency's smallest unit — for USD that means cents (e.g. `1000` = $10.00, `1000000` = $10,000.00). The card must belong to the authenticated user.
- [List Cards](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/list-cards.md): List all cards for the authenticated user. Returns both virtual and physical cards. Returns an empty list if no cardholder has been created yet.
- [Set Card Daily Spending Limit](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/set-card-daily-spending-limit.md): Sets the daily spending limit for a card. `amount` is in the currency's smallest unit — for USD that means cents, so to set a $10.00 limit send `1000`, and the maximum allowed value `1000000` corresponds to $10,000.00. Must be in (0, 1,000,000]. Only USD is currently accepted. The card must belong t…
- [Unblock Card](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/cards/unblock-card.md): Unblocks a previously blocked card. Restores the card to active status, allowing transactions again. The card must belong to the authenticated user's cardholder.
- [Health check endpoint](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/health-check-endpoint.md): Check if the service is running and get basic system information
- [Get PCI EIP-712 Challenge](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/pci/get-pci-eip-712-challenge.md): Issues a one-time EIP-712 challenge. The response is a complete typed-data object that can be passed directly to signTypedData (convert message.nonce to BigInt first). After signing, forward the hex signature as x-eip712-signature and the nonce as x-eip712-nonce on the subsequent PCI data request. T…
- [Get Phone Number](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/phone/get-phone-number.md): Returns the user's phone number if at least one card was created.
- [Update Phone Number](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/phone/update-phone-number.md): Updates the user's phone number on their cardholder record.
- [Get SOF Questions](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/source-of-funds/get-sof-questions.md): Get the Source of Funds questionnaire questions and answer options
- [Submit SOF Answers](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/source-of-funds/submit-sof-answers.md): Submit answers to the Source of Funds questionnaire
- [Accept Terms](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/terms/accept-terms.md): Accept one or more terms types and versions
- [Get User Terms Status](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/terms/get-user-terms-status.md): Get the authenticated user's terms acceptance status
- [List Available Terms](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/terms/list-available-terms.md): Get all available terms types with current versions (public)
- [Create Account](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/create-account.md): Create an account for the authenticated user.
- [Create Withdrawal](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/create-withdrawal.md): Create a withdrawal request for the authenticated user. Requires an existing account.
- [Get Account](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-account.md): Get the account details for the authenticated user. Returns the account from core api.
- [Get Account Balances](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-account-balances.md): Deprecated: use /user/balances/v2 instead. Returns the authenticated user's account balances, including spendable amount and deduction breakdown.
- [Get Account Balances (v2)](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-account-balances-v2.md): Returns the authenticated user's account balances. Spendable excludes dust and processingWithdrawals is exposed at the currency level. Each currency row includes a per-token breakdown.
- [Get Account Daily Spending Limit](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-account-daily-spending-limit.md): Returns the daily spending limit configured on the authenticated user's account. `amount` is in the currency's smallest unit — for USD that means cents (e.g. `1000` = $10.00, `1000000` = $10,000.00). `syncStatus` indicates whether the most recent update has been applied downstream.
- [Get Account Statement](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-account-statement.md): Returns a chronological list of all financial movements for the authenticated user's account, including card transactions (both pending and settled), deposits, and withdrawals.
- [Get Current User](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-current-user.md): Get the current authenticated user from the database
- [Get Onboarding Status](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-onboarding-status.md): Get the current onboarding status for the authenticated user. Returns a tagged union indicating the current step and any required actions.
- [Get User Deposits](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-user-deposits.md): Returns the authenticated user's deposit history, including amount, currency, status, and creation date.
- [Get User Withdrawals](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/get-user-withdrawals.md): Returns the authenticated user's withdrawal history, including amount, currency, status, and creation date.
- [Register User](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/register-user.md): Register a new user with email OTP verification and create a profile in core api. You receive a new JWT access token with user id that you can use to authenticate requests to the API. Optionally provide a shareToken for Sumsub reusable KYC.
- [Set Account Daily Spending Limit](https://gnosispay-feat-v2-auth-module.mintlify.app/api-reference/user/set-account-daily-spending-limit.md): Sets the daily spending limit for the authenticated user's account. `amount` is in the currency's smallest unit — for USD that means cents, so to set a $10.00 limit send `1000`, and the maximum allowed value `1000000` corresponds to $10,000.00. Must be in (0, 1,000,000]. Only USD is currently accept…
- [Partner Secure Elements (PSE) Integration](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/cards/v2-pse-integration.md): Display sensitive card information and manage PINs securely in your client application using PSE SDK (PSE version 3 with EIP-712 two-factor authentication).
- [Simulate Card Transactions](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/cards/v2-simulate-card.md): Simulate card transactions for testing purposes as part of sandbox environment.
- [Create Virtual Card](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/cards/v2-virtual-card.md): Create and Manage Virtual Cards for Users.
- [GP Account](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/gp-onchain/v2-account.md): Understanding Gnosis Pay V2 account architecture and modules
- [Account Statements](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/gp-onchain/v2-account-statement.md): Retrieve account statements for users
- [On-chain Withdrawals](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/gp-onchain/v2-withdraw.md): Create request to withdraw funds onchain to wallet address
- [GP V1 vs V2 Comparison](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/v1-v2-diff.md): Overview of the differences between GP V1 and V2 infra
- [Onboard to Gnosis Pay V2](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/v2-onboard.md): User onboarding using Gnosis Pay V2
- [Gnosis Pay V2 Overview](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/v2-overview.md): Welcome to Gnosis Pay V2 documentation
- [Authentication Guide](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/v2-siwe-auth.md): Guide for managing access authentication
- [Introduction to Webhooks](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/webhooks/webhook.md): Step-by-step guide to set up and implement webhooks in your application with Partner Dashboard
- [Webhook Events](https://gnosispay-feat-v2-auth-module.mintlify.app/v2/webhooks/webhook-events.md): Complete list of webhook events triggered in V2

## OpenAPI Specs

- [spec](https://api.gnosispay.com/api-docs/spec.json)
- [openapi](https://gp-auth-module.prod.gnosispay.com/openapi.json)