---
updatedAt: 2026-06-20T07:34:07.000Z
agentTools:
  projectIndex: https://docs.wirexapp.com/llms.txt
---

# Approve request

Approves 3DS request allowing the transaction to proceed

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "response.EmptyResponse": {
        "type": "object"
      },
      "response.ErrorCategory": {
        "properties": {
          "category": {
            "type": "string"
          },
          "grpc_status_code": {
            "type": "integer"
          },
          "http_status_code": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "response.ErrorDetails": {
        "properties": {
          "details": {
            "type": "string"
          },
          "key": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ErrorResponse": {
        "properties": {
          "error_category": {
            "$ref": "#/components/schemas/response.ErrorCategory"
          },
          "error_description": {
            "type": "string"
          },
          "error_details": {
            "items": {
              "$ref": "#/components/schemas/response.ErrorDetails"
            },
            "type": "array"
          },
          "error_reason": {
            "example": "ErrorInvalidField",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "ChainId": {
        "description": "EIP-155 id of the chain that the request should be executed for (e.g. 1001996)",
        "in": "header",
        "name": "X-Chain-Id",
        "type": "apiKey"
      },
      "UserAddress": {
        "description": "Address of the crypto wallet associated with the user for whom the request should be executed.",
        "in": "header",
        "name": "X-User-Wallet",
        "type": "apiKey"
      },
      "WirexPartnerToken": {
        "description": "Token obtained using Wirex Partner Credentials grant flow. Please see [Authentication](doc:authentication) Server-to-Server Authentication section",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      },
      "WirexUserToken": {
        "description": "Wirex issued JWT token that can be obtained by following [Authentication](doc:authentication) User Token Issuance section",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "contact": {
      "email": "company@wirexpaychain.com",
      "name": "API Support Team"
    },
    "description": "The **Wirex BaaS API** enables partners to deliver non-custodial financial services directly to their retail users. Through a single integration, partners can onboard users, verify identities, issue smart wallet–linked cards, and enable crypto-backed bank transfers—without ever handling fiat or taking custody of user funds.</br>All transactions are powered by **user-owned smart wallets**, ensuring security, transparency, and full user control. Wirex acts as the infrastructure provider, so you can focus on building exceptional user experiences while we handle the heavy lifting.",
    "title": "Wirex Retail BaaS API",
    "version": "1.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/v1/cards/3ds/requests/{transactionId}/approve": {
      "post": {
        "description": "Approves 3DS request allowing the transaction to proceed",
        "parameters": [
          {
            "description": "Identifier of transaction for which 3DS decision is made",
            "in": "path",
            "name": "transactionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.EmptyResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "WirexUserToken": []
          },
          {
            "ChainId": [],
            "UserAddress": [],
            "WirexPartnerToken": []
          }
        ],
        "summary": "Approve request",
        "tags": [
          "Cards/3DS"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api-baas.wirexapp.com"
    },
    {
      "url": "https://api-baas.wirexapp.tech"
    }
  ],
  "tags": [
    {
      "description": "The **Card 3DS APIs** enable clients to securely manage 3D Secure (3DS) authentication requests initiated during card transactions.\n\n### Key Capabilities\n\n- **Retrieve Active Challenges**: Access pending 3DS requests that require user action.\n- **Approve or Reject**: Handle a specific challenge using an action token acquired from the [Confirmation](#tag/Confirmation) section.\n\n### Security\n\nAll challenge responses require a valid, signed action token to confirm that the user has explicitly authorized the operation with their\nprivate key.\n\n> This section ensures robust authentication for sensitive card activities, preventing unauthorized use and supporting compliance with 3DS protocols.",
      "name": "Cards/3DS"
    }
  ],
  "x-readme": {}
}
```