Vantiv · Schema

Vantiv Transaction

A payment transaction processed through the Vantiv CNP API

PaymentsPayment ProcessingeCommerceFinanceFinTechFortune 1000

Properties

Name	Type	Description
merchantId	string	Vantiv merchant account identifier
id	string	Unique request identifier (max 25 characters)
orderId	string	Merchant-assigned order identifier
amount	integer	Transaction amount in cents (e.g., $10.00 = 1000)
cnpTxnId	integer	Vantiv-assigned transaction ID for downstream operations
response	string	Response code (000 = Approved)
message	string	Human-readable response message
authCode	string	Authorization code from card network
orderSource	string	Channel through which the order was placed
postDate	string	Date the transaction was posted
responseTime	string	Timestamp of the authorization response

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vantiv/main/json-schema/vantiv-transaction-schema.json",
  "title": "Vantiv Transaction",
  "description": "A payment transaction processed through the Vantiv CNP API",
  "type": "object",
  "required": ["merchantId", "id", "orderId", "amount"],
  "properties": {
    "merchantId": {
      "type": "string",
      "description": "Vantiv merchant account identifier"
    },
    "id": {
      "type": "string",
      "maxLength": 25,
      "description": "Unique request identifier (max 25 characters)"
    },
    "orderId": {
      "type": "string",
      "description": "Merchant-assigned order identifier"
    },
    "amount": {
      "type": "integer",
      "minimum": 1,
      "description": "Transaction amount in cents (e.g., $10.00 = 1000)"
    },
    "cnpTxnId": {
      "type": "integer",
      "format": "int64",
      "description": "Vantiv-assigned transaction ID for downstream operations"
    },
    "response": {
      "type": "string",
      "description": "Response code (000 = Approved)"
    },
    "message": {
      "type": "string",
      "description": "Human-readable response message"
    },
    "authCode": {
      "type": "string",
      "description": "Authorization code from card network"
    },
    "orderSource": {
      "type": "string",
      "enum": ["ecommerce", "moto", "recurring", "installment"],
      "description": "Channel through which the order was placed"
    },
    "postDate": {
      "type": "string",
      "format": "date",
      "description": "Date the transaction was posted"
    },
    "responseTime": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp of the authorization response"
    }
  }
}