---
updatedAt: 2025-04-28T20:08:39.000Z
agentTools:
  projectIndex: https://developer.finvi.com/llms.txt
---

# Customer Transaction - New Credit Card

Customer Transaction - New Credit Card

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Transactions",
    "description": "This resource provides access to process and query transaction data.",
    "termsOfService": "https://swervepay.qc.ontariosystems.cloud/LICENSE-2.0.html",
    "contact": {
      "name": "Finvi",
      "url": "https://swervepay.qc.ontariosystems.cloud/",
      "email": "payments@finvi.com"
    },
    "license": {
      "name": "SwervePay licence",
      "url": "https://finvi.com"
    },
    "version": "1.0.8"
  },
  "servers": [
    {
      "url": "https://api.swervepay.com/v/2.0/",
      "description": "This is a production server for SwervePay"
    }
  ],
  "tags": [
    {
      "name": "Base Resource: Transactions",
      "description": "The base transactions resource is used to query transaction data or run new transactions. A sub-resource is available for querying specific transaction details."
    }
  ],
  "paths": {
    "/{accountSid}/transactions#three": {
      "post": {
        "security": [
          {
            "basicAuth": []
          }
        ],
        "summary": "Customer Transaction - New Credit Card",
        "operationId": "queryTransactionNew",
        "description": "Customer Transaction - New Credit Card",
        "tags": [
          "Base Resource: Transactions"
        ],
        "parameters": [
          {
            "name": "accountSid",
            "in": "path",
            "description": "Account Number from the calling system",
            "schema": {
              "minLength": 0,
              "maxLength": 256
            },
            "required": true
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/NewccReq"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "$ref": "#/components/schemas/NewccRes"
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "$ref": "#/components/schemas/NewccRes"
                }
              }
            }
          },
          "404": {
            "description": "URL not found"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "NewccReq": {
        "type": "object",
        "properties": {
          "accountNumber": {
            "description": "Credit card account number or ACH bank account number",
            "maxLength": 16,
            "example": ""
          },
          "billAddress1": {
            "description": "Address Line 1",
            "maxLength": 255,
            "example": ""
          },
          "billCity": {
            "description": "City",
            "maxLength": 255,
            "example": ""
          },
          "billEmail": {
            "description": "Email",
            "maxLength": 255,
            "example": ""
          },
          "billFirstName": {
            "description": "First Name",
            "maxLength": 32,
            "example": ""
          },
          "billLastName": {
            "description": "Last Name",
            "maxLength": 32,
            "example": ""
          },
          "billPhoneNumber": {
            "description": "Mobile Number",
            "maxLength": 14,
            "example": ""
          },
          "billState": {
            "description": "2-letter state abbreviation",
            "maxLength": 2,
            "example": ""
          },
          "billZip": {
            "description": "ZIP code",
            "maxLength": 10,
            "example": ""
          },
          "cardExpirationDate": {
            "description": "Credit Card Expiration Date",
            "maxLength": 4,
            "example": ""
          },
          "customerId": {
            "description": "Customer ID",
            "maxLength": 12,
            "example": ""
          },
          "transactionAmount": {
            "description": "Amount",
            "maxLength": 12,
            "example": ""
          },
          "transactionSource": {
            "description": "Transaction Source",
            "maxLength": 10,
            "example": ""
          },
          "transactionType": {
            "description": "Transaction Type",
            "maxLength": 10,
            "example": ""
          }
        }
      },
      "NewccRes": {
        "type": "object",
        "properties": {
          "accountNumber": {
            "description": "Masked credit card account number or ACH bank account number",
            "maxLength": 16,
            "example": "6011xxxxxxxx2006"
          },
          "accountRefId": {
            "description": "The Account Number from the calling system",
            "maxLength": 256,
            "example": "2kzb!NzPji6Ns6DD2%^qYj89Y"
          },
          "authCode": {
            "description": "Authorization Code",
            "maxLength": 6,
            "example": 123456
          },
          "avsResult": {
            "description": "AVS response code.",
            "maxLength": 1,
            "example": "N"
          },
          "billAddress1": {
            "description": "Address Line 1",
            "maxLength": 252,
            "example": "181 Woodbridge Lane"
          },
          "billAddress2": {
            "description": "Address Line 2",
            "maxLength": 255,
            "example": null
          },
          "billCity": {
            "description": "City",
            "maxLength": 255,
            "example": "Detroit"
          },
          "billCompany": {
            "description": "Company",
            "maxLength": 255,
            "example": null
          },
          "billEmail": {
            "description": "Email",
            "maxLength": 255,
            "example": "PatriciaKSteele@rhyta.com"
          },
          "billFaxNumber": {
            "description": "Fax Number",
            "maxLength": 14,
            "example": null
          },
          "billFirstName": {
            "description": "First Name",
            "maxLength": 32,
            "example": "Patricia"
          },
          "billLastName": {
            "description": "Last Name",
            "maxLength": 32,
            "example": "Steele"
          },
          "billPhoneNumber": {
            "description": "Mobile Number",
            "maxLength": 14,
            "example": "(313) 456-6415"
          },
          "billSecondaryNumber": {
            "description": "Secondary Number",
            "maxLength": 14,
            "example": null
          },
          "billState": {
            "description": "2-letter state abbreviation",
            "maxLength": 2,
            "example": "MI"
          },
          "billZip": {
            "description": "ZIP code",
            "maxLength": 10,
            "example": 48202
          },
          "cardExpirationDate": {
            "description": "Credit card expiration date (MMYY), if applicable",
            "maxLength": 4,
            "example": 1016
          },
          "clientRefId": {
            "description": "The external Id from the calling system",
            "maxLength": 256,
            "example": "qtb$Xa4KbrkE"
          },
          "customerId": {
            "description": "Customer Id",
            "maxLength": 12,
            "example": 200000027190
          },
          "cvvResult": {
            "description": "CVV response code.",
            "maxLength": 1,
            "example": null
          },
          "finviResponseCode": {
            "description": "Numeric mapping of processor response",
            "example": 100
          },
          "finviResponseCodeDesc": {
            "description": "Description mapping of processor response",
            "example": 100
          },
          "invoiceId": {
            "description": "Invoice Id",
            "maxLength": 12,
            "example": null
          },
          "originalTransactionId": {
            "description": "The transactionId of the original transaction relating to this transaction. This will be the same as the transactionId for this transaction unless the transaction relates to other transactions. In the case of a refund, for example, the originalTransactionId for the refund transaction will be the transactionId of the original sale transaction.",
            "maxLength": 12,
            "example": 100000033972
          },
          "paperCheckNumber": {
            "description": "Check Number",
            "maxLength": 12,
            "example": null
          },
          "paymentPlanId": {
            "description": "Payment Plan Id",
            "maxLength": 12,
            "example": null
          },
          "processingFee": {
            "description": "Admin Fee",
            "maxLength": 12,
            "example": "0.00"
          },
          "responseCode": {
            "description": "Numeric mapping of processor response.",
            "example": 100
          },
          "responseMessage": {
            "description": "Human readable response message",
            "maxLength": 255,
            "example": "SUCCESS"
          },
          "routingNumber": {
            "description": "ACH routing number, if applicable",
            "maxLength": 9,
            "example": null
          },
          "timestamp": {
            "description": "Timestamp. Date/time format is YYYY-MM-DD HH:MM:SS. The timezone is in GMT",
            "maxLength": 19,
            "example": "2013-11-29 22:58:41"
          },
          "tokenId": {
            "description": "Token Id",
            "maxLength": 12,
            "example": 30188
          },
          "transactionAmount": {
            "description": "Amount",
            "maxLength": 12,
            "example": 722.66
          },
          "transactionEventOrder": {
            "description": "The order in which transactions relating to this originalTransactionId occurred (beginning with 1)",
            "example": 1
          },
          "transactionId": {
            "description": "Transaction unique identifier",
            "maxLength": 12,
            "example": 100000033972
          },
          "transactionMethod": {
            "description": "Method used to process the transaction",
            "maxLength": 15,
            "example": "manual"
          },
          "transactionRefId": {
            "description": "The Transaction Reference Id from the calling system",
            "maxLength": 256,
            "example": null
          },
          "transactionSource": {
            "description": "Transaction Source",
            "maxLength": 10,
            "example": "cc"
          },
          "transactionStatus": {
            "description": "Transaction Status",
            "maxLength": 7,
            "example": "success"
          },
          "transactionType": {
            "description": "Transaction Type",
            "maxLength": 10,
            "example": "sale"
          },
          "username": {
            "description": "Username of the user who issued the transaction",
            "maxLength": 255,
            "example": "testuser"
          }
        }
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```