ZenPayments
  1. Submiting External Transactions
ZenPayments
  • General Information
    • Authentication
    • Errors
    • Responses
    • Filters
      • Example - gte
      • Example - between
      • Example - like
      • Example - in
      • Example - non-empty
    • Pagination
      • 10 results per page
    • Data Types
  • Merchants
    • Sandbox
      • Sandbox Payment Gateway
    • Card Payments
      • Authorization
      • Sale
      • Capture
      • Partial Capture
      • Refund
      • Partial Refund
      • Soft/Dynamic Descriptor
      • Card Authentication
      • Card Tokenization
      • Card Tokenization with Global Token
      • Sale with a Fee Terminal
    • Hosted Form
      • Generate
      • Generate with Billing and Contact Information
    • Hosted Fields
      • How it Works
      • Hosted Fields Token
        • Hosted Fields Token
      • Integration Guide
        • Step 1: Include the JavaScript Library
        • Step 2: Add HTML Elements for all payment fields
        • Step 3: Set the AccessToken and Configure the rest of the form
        • Step 4: Add styling
        • Step 5: Listen for Events
        • Step 6: Get the tokenized card
          • Get the tokenized card
        • Add Payment Method Page
        • Testing your integration
    • CustomerVault
      • Sandbox
        • Sandbox Dashboard
      • Hosted Card Form
        • Generate
      • Customers
        • List
        • View
        • Create
        • Update
        • Archive
        • Delete
      • Cards
        • List Cards
        • View
        • Add Card
        • Update Exp Date
        • Archive
        • Unarchive
        • Delete
      • Billing Information
        • List
        • View
        • Update
        • Create
      • Shipping Information
        • List
        • View
        • Update
        • Create
      • Recurring Payment
        • List
        • View
        • Update
        • Create
    • Transaction Reporting
      • List
      • View
    • Response Codes
      • Verification Response Codes
    • 3DSecure
      • Version
      • Create
        • Create
      • Check
        • Check
      • Test Cards
    • Account Updater
      • Card Compatibility
      • How It Works
        • Sale with Account Updater
    • ACH Payments
      • General Information
      • Transactions
        • SEC Codes
        • Statuses
        • Actions
          • Action
        • History Log
          • Log
        • List
        • View
        • Create ACH
        • Create ACH & Save Customer
        • Create ACH for an existing Customer
        • Create ACH for an existing Customer and specific Account
        • Remove
      • Hosted Form
        • Example Request
      • Customers
        • List Customers
        • View specific Customer
        • Create Customer
        • Update Customer
        • Delete a Customer
      • Customer Accounts
        • List Customer Accounts
        • Create Customer Account
        • Update Customer Account
        • Delete a Customer Account
      • Bank Information
        • View
      • ACH Settlements
        • List
        • View
      • ACH Webhooks
        • New ACH Record
        • ACH Status Update
        • New ACH Customer
    • Reporting
      • Sandbox
        • Sandbox Dashboard
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
        • View
          • List
          • View
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Visa Verifi
        • Submiting External Transactions
          • Submit
            POST
        • List
          GET
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Gateway Test Cards
  • Platforms
    • Sandbox
      • Sandbox Dashboard
    • Onboarding
      • Boarding Applications
        • Campaigns
          • List
        • Equipment
          • Terminals
            • List
            • View
          • View
          • Update
        • List
          • List Boarding Applications
        • Create
          • Create Boarding Application
        • Delete
          • Delete Boarding Application
        • View
          • View Boarding Application
        • Update
          • Update Boarding Application
        • Principals
          • List Principals
          • Create Principal
          • Update a Single Principal
          • Mass update Principals
          • Delete Principal
        • Processing
          • View Processing section
          • Update Processing section
        • Merchant Category Codes (MCCs)
          • List MCCs
        • ACH
          • View ACH section
          • Update ACH section
        • Documents
          • Attachment About
            • List All Document Categories
          • View all documents
          • MPA
          • Assign a single document
          • Assign multiple documents
          • Update a single document
          • Delete a single document
        • Fees
          • Types
            • List
          • Other Fees
            • Add
            • Update
            • Delete
          • List all fees
          • View a specific fee
          • Update a single fee
          • Update multiple fees
        • Bank Accounts
          • Add
          • Update
          • Change
        • Validate
          • Validate a Boarding Application
        • URL
          • GET URL of Boarding Application
        • Signature
          • Request E-sign
            • Request Signature
          • Embed E-sign
            • Embeded E-sign Example Flow 1
            • Embeded E-sign Example Flow 2
            • Request Embed
          • Manually Signing
            • Manual Sign
          • External eSign Signing
            • External eSign
        • Automation
          • AutoSign
            • Set AutoSign
          • AutoUnderwriting
            • Set AutoUnderwriting
        • Status
          • Set status to Underwriting
        • Notes
          • List
          • Create
      • Merchants
        • Terminals
          • List Terminals
          • View a specific Terminal
          • VAR Sheet
          • VAR View
        • List Merchants
      • DBA
        • List
        • View
      • Attachments
        • Temporary Upload
          • Temporary Upload
        • Chunk Upload
          • Initialize
          • Upload Request 1/2
          • Upload Request 2/2
        • Standard Upload
        • List attachments
        • View
        • View in browser
        • Download
        • Delete
      • Webhooks
        • Signatures
        • Events
          • Boarding Application
          • Merchant
            • Account
              • New Acquiring Account
              • New ACH Account
              • Closed Acquiring Account
              • Closed ACH Account
            • Terminal
              • New Terminal Record
              • Update Terminal Record
              • Delete Terminal Record
    • Reporting
      • Authorizations
        • List
        • List with Filters
      • Batches
        • List
        • List with Filters
        • Summary
      • Payouts
        • List
        • View
        • Export
      • Chargebacks
        • View
          • List
          • View
        • Disputes
          • Upload a temporary file
          • Create a Dispute
          • Preview
          • Submit
        • Webhooks
          • Signatures
          • Events
            • Chargeback
              • New Chargeback Record
              • Chargeback Update
      • Statements
        • List
        • Download
      • Reserve
        • List
      • Fraud Report
        • Generate
      • Other Reports
        • Request a Report
        • Check Status
        • Download
    • Residuals
      • List
      • View
    • Tickets
      • Update Ticket Status
        • Close
        • Re-Open
      • Responses
        • List
        • Create
        • Add an Attachment
      • Attachments
        • List
        • View
        • Create
        • Delete
      • Categories
        • List
      • Notes
        • List
        • View
        • Create
        • Update
        • Delete
        • Attachments
      • List
      • Create
      • View a specific ticket
    • Connect
      • Webhooks
        • Access Granted
        • Access Updated
        • Access Revoked
    • Misc
      • Address Checker
        • List Countries
        • List States
        • List Cities and Zip Codes
        • Filter by City and State
      • BIN Check
        • Get BIN Information
  1. Submiting External Transactions

Submit

POST
/api/visa-verifi/<merchantAccountId>/transaction
FieldsDescriptionTypeFilterableRequired
terminalIdID of the terminal for which you're submitting external transactionIntegerNoYes
transactionIdUnique ID of the transaction in the external systemIntegerStringNo
amountTotal Amount of the transactionDecimalNoYes
dateDate of the transactionDatetimeNoYes
cardBinThe first six digits of the card used in the transactionIntegerNoYes
cardNumberThe last four digits of the card used in the transactionIntegerNoYes
cardExpDateCard Expiration DateDateNoYes
authCodeTransaction Auth CodeStringNoNo
arnTransaction ARN NumberStringNoNo
ipIP Address from which the transaction was madeStringNoYes
orderObject with order informationObjectNoYes
order.orderNumberNumber of order. If N/A you can provide the invoice numberStringIntegerNo
order.invoiceInvoice NumberStringIntegerNo
order.taxAmountTotal Amount of taxes for the orderDecimalNoNo
order.productsList of purchased products[Object]NoYes
order.taxsesList of taxses[Object]NoYes
order.billingInformation for customer billing[Object]NoYes
order.shippingInformation for order shipping[Object]NoYes
cardholderInformation for the cardholderObjectNoYes
cardholder.nameCardholder NameStringNoYes
cardholder.countryCardholder CountryStringNoYes
cardholder.cityCardholder cityStringNoYes
cardholder.stateCardholder stateStringNoNo
cardholder.streetCardholder streetStringNoYes
cardholder.zipCardholder zipStringNumberNo
contactCardholder ContactObjectNoYes
contact.nameContact NameStringNoYes
contact.phoneContact PhoneStringNoYes
contact.emailContact Valid Email AddressStringNoYes
Product Object#
This is the structure of each product object. When submitting the external transaction please provide a list of these objects inside order.products field.
FieldsDescriptionTypeFilterableRequired
nameName of the purchased productStringNoYes
pricePrice of а single productDecimalNoYes
quantityQuantity of purchased productsIntegerNoYes
Example Product Object#
{
    "name": "Hosting",
    "price": "24.00",
    "quantity": "1.00",
}
Tax Object#
This is the structure of each tax object. When submitting the external transaction please provide a list of these objects inside order.taxses field.
FieldsDescriptionTypeFilterableRequired
typeType of taxStringNoYes
amountTax amountDecimalNoYes
rateTax rateIntegerNoYes
categoryTax categoryStringNoYes
Example Tax Object#
{
    "type": "VAT",
    "amount": "2.40",
    "rate": "10.00",
    "category": "VAT"
}
Billing Object#
This is the structure of the billing object. It provides data about the billed person. When submitting the external transaction please provide it under order.billing field.
FieldsDescriptionTypeFilterableRequired
nameName of the billed personStringNoYes
countryCountryStringNoYes
stateStateStringNoNo
cityCityStringNoYes
streetStreetStringNoYes
zipZipStringNumberNo
Example Billing Object#
{
    "name": "Craig  Dewayne",
    "country": "United States",
    "state": "Arkansas",
    "city": "Pea Ridge",
    "street": "1302 Spruce St",
    "zip": "72751"
}
Shipping Object#
This is the structure of the Shipping object. It provides data about the order shipping. When submitting the external transaction please provide it under order.shipping field.
FieldsDescriptionTypeFilterableRequired
fromZipShipping from zipStringNumberNo
toAddressDelivery address informationStringNoYes
toCityDelivery city informationStringNoNo
toZipShipping to zipStringNumberNo
toCountryShipping CountryStringNoYes
Example Shipping Object#
{
    "toCountry": "United States",
    "toCity": "Pea Ridge",
    "toAddress": "1302 Spruce St",
    "toZip": "72751",
    "fromZip": "31151"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/visa-verifi/<merchantAccountId>/transaction' \
--header 'Authorization: Bearer <token>'

Responses

🟢200成功
application/json
Body

Example
{}
Modified at 2025-08-09 05:39:41
Previous
Submiting External Transactions
Next
List
Built with