Versapay

Versapay Card Present EMV API

Card Present EMV payment transactions require a Versapay certified point-of-sale terminal. Contact support@versapay.com for support & setup for POS/CP EMV enablement.

Documentation GitHub OpenAPI

Operations 1

POST /api/gateway/v1/terminal Issue a direct command to a POS terminal e.g. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/versapay-card-present-emv-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  version: 1.3.35
  title: Versapay API Reference Card Present EMV API
  contact:
    name: Versapay Support
    url: https://www.versapay.com/support
    email: support@versapay.com
  x-logo:
    url: https://developers.versapay.com/images/logo.png
  termsOfService: https://www.versapay.com/terms-of-use
  license:
    name: Copyright 2022 Versapay. All Rights Reserved.
  description: Card Present EMV payment transactions require a Versapay certified point-of-sale terminal. Contact support@versapay.com for support & setup for POS/CP EMV enablement.
servers:
- url: https://secure.versapay.com
  description: Production
- url: https://uat.versapay.com
  description: UAT
tags:
- name: Card Present EMV
  description: Card Present EMV payment transactions require a Versapay certified point-of-sale terminal. Contact support@versapay.com for support & setup for POS/CP EMV enablement.
paths:
  /api/gateway/v1/terminal:
    post:
      tags:
      - Card Present EMV
      summary: Issue a direct command to a POS terminal e.g.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TerminalRequest'
            examples:
              tc_device_setup:
                $ref: '#/components/examples/tc_device_setup'
              tc_request_signature:
                $ref: '#/components/examples/tc_request_signature'
              tc_cancel:
                $ref: '#/components/examples/tc_cancel'
              tc_device_status:
                $ref: '#/components/examples/tc_device_status'
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TerminalResponse'
              examples:
                success:
                  summary: Successful terminal command
                  value:
                    success: true
                fail:
                  summary: Failed terminal command
                  value:
                    success: false
        '500':
          description: 500 error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedResponse'
              examples:
                declined_invalid_card:
                  $ref: '#/components/examples/declined_invalid_card'
                declined:
                  $ref: '#/components/examples/declined'
                error:
                  $ref: '#/components/examples/error'
      operationId: postApiGatewayV1Terminal
      x-operation-id-source: derived
components:
  schemas:
    TerminalResponse:
      type: object
      properties:
        success:
          type: boolean
          description: true|false
      example:
        success: true
    TerminalRequest:
      type: object
      properties:
        laneid:
          type: string
          description: Pre-configured lane identifier
        command:
          type: string
          description: Supported terminal command
          enum:
          - DeviceSetup
          - RequestSignature
          - Cancel
          - DeviceStatus
      example:
        laneid: '1'
        command: DeviceSetup
    UnifiedResponse:
      type: object
  examples:
    tc_device_status:
      summary: Device status
      value:
        laneid: '1'
        command: DeviceStatus
    tc_request_signature:
      summary: Request signature
      value:
        laneid: '1'
        command: RequestSignature
    error:
      summary: Other errors
      value:
        success: false
        errors:
        - order_not_found
    tc_cancel:
      summary: Cancel
      value:
        laneid: '1'
        command: Cancel
    declined:
      summary: Gateway declined request
      value:
        success: false
        errors:
        - declined for REASON
    declined_invalid_card:
      summary: Decline invalid card
      value:
        success: false
    tc_device_setup:
      summary: Device setup
      value:
        laneid: '1'
        command: DeviceSetup
x-tagGroups:
- name: Versapay API
  description: Introduction to the Versapay API.
  tags:
  - Overview
  - Versioning & Compatibility
  - Environments
  - Rate Limits
  - Authentication
  - Webhooks
  - Watermark & Limit
- name: Collaborative AR
  description: Operations available for Collaborative AR integration.
  tags:
  - Reference Data
  - Onboarding
  - Ecommerce Integration
  - Orders
  - Order Transactions
  - Testing Order Transactions
  - Gift Cards
  - Card Present EMV
  - Settlement Reporting
  - Wallets
  - Customers
  - Invoices
  - Autopay
  - Invoicing Payments
  - Divisions
  - Notifications
  - Collaboration
  - File Imports