---
updatedAt: 2025-12-04T19:06:37.000Z
---

Fetch the complete documentation index at: https://kb.valorvpc.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Auth

An authorization confirms that a payment card account holds enough funds to pay for a purchase.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "beaconapp",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://apitest.valorvpc.com"
    }
  ],
  "security": [],
  "paths": {
    "/payment/auth": {
      "post": {
        "summary": "Auth",
        "description": "An authorization confirms that a payment card account holds enough funds to pay for a purchase.",
        "operationId": "auth",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Key",
            "schema": {
              "type": "string",
              "default": ""
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "merchantId": {
                    "type": "string",
                    "default": "855500000027"
                  },
                  "terminalId": {
                    "type": "string",
                    "default": "48593451"
                  },
                  "paymentType": {
                    "type": "string",
                    "default": "auth"
                  },
                  "amount": {
                    "type": "string",
                    "default": "15"
                  },
                  "cardData": {
                    "properties": {
                      "panNumber": {
                        "type": "string",
                        "default": "4111111111111111"
                      },
                      "expiryDate": {
                        "type": "string",
                        "default": "1130"
                      },
                      "cvv": {
                        "type": "string",
                        "default": "999"
                      }
                    },
                    "required": [
                      "panNumber",
                      "expiryDate"
                    ],
                    "type": "object"
                  },
                  "commerceIndicator": {
                    "type": "string",
                    "default": "moto"
                  }
                },
                "required": [
                  "merchantId",
                  "terminalId",
                  "paymentType",
                  "amount",
                  "cardData",
                  "commerceIndicator"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-App-Key",
        "value": "f63e6ab9-6f3f-4081-ab45-9a941f8e1344"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```