Vantiv · JSON Structure
Vantiv Transaction Structure
Payment transaction processed through the Vantiv CNP API
Type:
Properties: 0
PaymentsPayment ProcessingeCommerceFinanceFinTechFortune 1000
VantivTransaction is a JSON Structure definition published by Vantiv.
Meta-schema:
JSON Structure
{
"name": "VantivTransaction",
"description": "Payment transaction processed through the Vantiv CNP API",
"fields": [
{ "name": "merchantId", "type": "string", "required": true, "description": "Merchant account ID" },
{ "name": "id", "type": "string", "required": true, "description": "Request ID (max 25 chars)" },
{ "name": "orderId", "type": "string", "required": true, "description": "Merchant order identifier" },
{ "name": "amount", "type": "integer", "required": true, "description": "Amount in cents" },
{ "name": "cnpTxnId", "type": "integer(int64)", "required": false, "description": "Vantiv transaction ID" },
{ "name": "response", "type": "string", "required": false, "description": "Response code (000=Approved)" },
{ "name": "message", "type": "string", "required": false, "description": "Response message" },
{ "name": "authCode", "type": "string", "required": false, "description": "Auth code from network" },
{ "name": "orderSource", "type": "enum", "required": false, "values": ["ecommerce", "moto", "recurring", "installment"], "description": "Order channel" },
{ "name": "postDate", "type": "date", "required": false, "description": "Post date" },
{ "name": "card", "type": "CardType", "required": false, "description": "Card details" },
{ "name": "billToAddress", "type": "AddressType", "required": false, "description": "Billing address for AVS" }
],
"nested": [
{
"name": "CardType",
"fields": [
{ "name": "type", "type": "enum", "values": ["VI", "MC", "AX", "DI", "JC"], "description": "Card brand" },
{ "name": "number", "type": "string", "description": "Card PAN or token" },
{ "name": "expDate", "type": "string", "description": "Expiration MMYY" },
{ "name": "cardValidationNum", "type": "string", "description": "CVV code" }
]
},
{
"name": "AddressType",
"fields": [
{ "name": "name", "type": "string", "description": "Cardholder name" },
{ "name": "addressLine1", "type": "string", "description": "Street address" },
{ "name": "city", "type": "string", "description": "City" },
{ "name": "state", "type": "string", "description": "State code" },
{ "name": "zip", "type": "string", "description": "Postal code" },
{ "name": "country", "type": "string", "description": "Country code" }
]
}
]
}