AUTHCAPTURE

AUTHCAPTURE is commonly known as a 'sale' transaction. It combines the functions of authorization and capture into a single transaction.

An AUTHCAPTURE is used for 'finalized' sale transactions in eCommerce, retail, and restaurant environments that have these features:

With eCommerce transactions, the AUTHCAPTURE is used for completed sales for for virtual products only; this DOES NOT include physical products that are to be delivered at a later time.
In the restaurant environment, the AUTHCAPTURE is used for completed sales with a known tip amount, or 'tip at the table'.
NOTE
There is NO tip adjustment after the sale, as this is no longer supported by various card associations with the use of chip cards.
Successful requests will be indicated with a 2xx HTTP response code and the Approved attribute set to 'true'.
NOTE
It is possible to receive a 2xx HTTP response code and have the Approved attribute set to 'false'.

Available Functions

Perform an 'authcapture' transaction

POST, /v0/transaction/authcapture

REQUEST Object Attributes

authCaptureTable
Attribute	Data Type	Description	Required
Amount	object	Amount Object	True
Total	decimal	Total Transaction Amount Total is aKey/Value of the "Amount" Object.	True
Tip	decimal	Tip associated with the Transaction Tip is aKey/Value of the "Amount" Object.	False
Fee	decimal	Fee associated with the Transaction Fee is aKey/Value of the "Amount" Object.	False
Tax	decimal	Tax associated with the Transaction Tax is aKey/Value of the "Amount" Object.	False
Taxable	decimal	The amount of the transaction that is subject to taxes (Used if only a portion of the transaction is taxable) Taxable is aKey/Value of the "Amount" Object.	False
Shipping	decimal	Shipping associated with the Transaction Shipping is aKey/Value of the "Amount" Object.	False
Duty	decimal	Duty associated with the Transaction Duty is aKey/Value of the "Amount" Object.	False
Discount	decimal	Discount associated with the Transaction (Informational Only) Discount is aKey/Value of the "Amount" Object.	False
Cashback	decimal	Use requires special permission from PayNetworx. Cash back amount associated with the Transaction Cashback is aKey/Value of the "Amount" Object.	False
Currency	string	ISO 3-letter currency code Currency is aKey/Value of the "Amount" Object.	True
Payment Method	object	Transaction Payment Method	True
Card	object	Card info Card is aKey/Value of the "Payment Method" Object.	True
CardPresent	boolean	Indicates if this card is present CardPresent is aKey/Value of the "Card" Object.	True
CVC	object	Card Verification Value (AKA CVV2) CVC is aKey/Value of the "Card" Object.	False
CVC	string	Card Verification Value (AKA CVV2) CVC is aKey/Value of the "CVC" Object.	False
PAN	object	Personal Account Number Info PAN is aKey/Value of the "Card" Object.	True
PAN	string	Personal Account Number PAN is aKey/Value of the "PAN" Object.	True
ExpMonth	string	Account Expiration Month (MM) ExpMonth is aKey/Value of the "PAN" Object.	True
ExpYear	string	Account Expiration Year (YY) ExpYear is aKey/Value of the "PAN" Object.	True
Track2	object	Track 2 Data Track2 is aKey/Value of the "Card" Object.	False
Track2	string	Track 2 string ("Start" and "End" sentinels required) Track2 is aKey/Value of the "Track2" Object.	False
PIN	object	PIN PIN is aKey/Value of the "Card" Object.	False
Data	string	PIN Data Data is aKey/Value of the "PIN" Object.	False
KSN	string	Key Serial Number KSN is aKey/Value of the "PIN" Object.	False
BillingAddress	object	Customer billing address BillingAddress is aKey/Value of the "Card" Object.	False
Name	string	Customer name (Full Name) Name is aKey/Value of the "BillingAddress" Object.	False
Line1	string	Customer address line 1 Line1 is aKey/Value of the "BillingAddress" Object.	False
Line2	string	Customer address line 2 Line2 is aKey/Value of the "BillingAddress" Object.	False
City	string	Customer city City is aKey/Value of the "BillingAddress" Object.	False
State	string	Customer state State is aKey/Value of the "BillingAddress" Object.	False
PostalCode	string	Customer postal code (AKA Zip Code) PostalCode is aKey/Value of the "BillingAddress" Object.	False
Country	string	Customer country Country is aKey/Value of the "BillingAddress" Object.	False
Phone	string	Customer Phone Number Phone is aKey/Value of the "BillingAddress" Object.	False
Email	string	Customer Email Email is aKey/Value of the "BillingAddress" Object.	False
ICC	object	See Attributes in Integrated Circuit Card Data Section ICC is aKey/Value of the "Card" Object.	False
3DSecure	object	3D Secure Result data for verification of card transactions 3DSecure is aKey/Value of the "Card" Object.	False
Authentication Value	string	Authentication value from 3D Secure results Authentication Value is aKey/Value of the "3DSecure" Object.	False
ECommerceIndicator	string	ECommerce indicator (ECI) from 3D Secure results ECommerceIndicator is aKey/Value of the "3DSecure" Object.	False
3DSecureTransactionID	string	3D Secure Transaction ID from 3D Secure results 3DSecureTransactionID is aKey/Value of the "3DSecure" Object.	False
Token	object	Indicates the Token ID as the payment method Token is aKey/Value of the "Payment Method" Object.	False
TokenID	ksuid	Token ID TokenID is aKey/Value of the "Token" Object.	False
DataAction	string	Data Action	False
Attributes	object	Transaction attributes	False
EntryMode	object	Description of the card entry mode EntryMode is aKey/Value of the "Attributes" Object.	False
ProcessingSpecifiers	object	Description of the specific data used for processing the transaction. ProcessingSpecifiers is aKey/Value of the "Attributes" Object.	False
TransactionDescriptor	object	Description of the transaction used for dynamic descriptors. TransactionDescriptor is aKey/Value of the "Attributes" Object.	False
Prefix	object	The Prefix for the transaction used for dynamic descriptors. Prefix is aKey/Value of the "TransactionDescriptor" Object.	False
Detail	object	The Detail for the transaction used for dynamic descriptors. Detail is aKey/Value of the "TransactionDescriptor" Object.	False
Recurring	object	See Recurring Section (Use with Recurring Payment, Standing Payment, Unscheduled Payment requests)	False
Detail	object	Transaction Details	False
MerchantData	object	Merchant Defined Transaction Data (supports 1 or more Merchant Defined Keys) MerchantData is aKey/Value of the "Detail" Object.	False
MerchantDefinedKey1	string	Merchant - defined transaction data (field 1) MerchantDefinedKey1 is aKey/Value of the "MerchantData" Object.	False
MerchantDefinedKey2	string	Merchant - defined transaction data (field 2) MerchantDefinedKey2 is aKey/Value of the "MerchantData" Object.	False
Order	object	Order data details for purchase (Standard Data and Corporate Data) Order is aKey/Value of the "Detail" Object.	False
Item	object array	Item data details for purchase (Standard Data and Corporate Data) Item is aKey/Value of the "Detail" Object.	False
ShipTo	object	ShipTo receiver data (Standard Data and Corporate Data) ShipTo is aKey/Value of the "Detail" Object.	False
ShipFrom	object	ShipFrom sender data (Standard Data and Corporate Data) ShipFrom is aKey/Value of the "Detail" Object.	False
Shipment	object array	Shipment details in Detail Shipment Data Section (Standard Data and Corporate Data) Shipment is aKey/Value of the "Detail" Object.	False
TransactionEntry	object	See Transaction Entry Section (Information about transaction entry)	False

REQUEST Object Non-Required Attributes

Non-required attributes should only be included if needed for your use case. If not used, they should be omitted from the request object.

When should I include non-required attributes?

"Fee" attribute:: Include only if adding a fee to the transaction
"Tip" attribute:: Include only if adding tip to a transaction
"Fee" attribute:: Include only if adding a fee to a transaction
"Tax" attribute:: Include only if adding tax to a transaction
"Taxable" attribute:: Include only if adding tax to a transaction
"Shipping" attribute:: Include only if adding shipping to a transaction
"Duty" attribute:: Include only if adding duty fees to a transaction
"Discount" attribute:: Include only if adding a discount to a transaction
"Cashback" attribute:: Use requires special permission from PayNetWorx. Include only if adding a cash back to a transaction
"CVC" attribute:: Include only if card verification value (aka CVV2) is present. Will take form of CVC: {CVC: 'string'}
"CVC" sub-attribute:: Include only if CVC attribute is used
"PIN" attribute:: Include only if making a transaction with a PIN. Will take form of PIN: {Data: 'string', KSN: 'string'}
"Data" sub-attribute:: Include only if PIN attribute is present
"KSN" sub-attribute:: Include only if PIN attribute is present
"Billing Address" attribute:: Include only if a billing Address is required for the transaction
"Name" sub-attribute:: Include only if a Billing Address is present
"Line1" sub-attribute:: Include only if a Billing Address is present
"Line2" sub-attribute:: Include only if a Billing Address is present and Line1 sub-attribute is not sufficient
"City" sub-attribute:: Include only if a Billing Address is present
"State" sub-attribute:: Include only if a Billing Address is present
"Postal Code" sub-attribute:: Include only if a Billing Address is present
"Country" sub-attribute:: Include only if a Billing Address is present
"Phone" sub-attribute:: Include only if a Billing Address is present, and Phone number is available
"Email" sub-attribute:: Include only if a Billing Address is present, and Email address is available
"DebitType" sub-attribute:: Include only if a this is a debit transaction
"Detail" attribute:: Include when specific transaction detail must accompany the request
"Order" attribute:: Include Order data details for purchases when the merchant prefers to provide data or needs to provide data (i.e., corporate cards)
"Items" attribute:: Include Items data details for purchases when the merchant prefers to provide data or needs to provide data (i.e., corporate cards)
"ShipTo" attribute:: Include ShipTo data details for purchases when the merchant prefers to provide data or needs to provide data (i.e., corporate cards)
"ShipFrom" attribute:: Include ShipFrom data details for purchases when the merchant prefers to provide data or needs to provide data (i.e., corporate cards)
"Shipment" attribute:: Include Shipment data details for purchases when the merchant prefers to provide data or needs to provide data (i.e., corporate cards)
"Merchant Data" attribute:: Include only if adding custom merchant defined transaction data using the "MerchantDefinedKey1" and/or "Merchant DefinedKey2" attribute(s)
"MerchantDefinedKey1" attribute:: Include only for adding custom merchant data (ex. OrderNumber, CustomerID)
"MerchantDefinedKey2" attribute:: Include only for adding custom merchant data (ex. OrderNumber, CustomerID)

The Request examples show example uses of optional fields in practice.

REQUEST Example: eCommerce

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Fee": 0.50,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "CardPresent": false,
            "CVC": {
                "CVC": "1234"
            },
            "PAN": {
                "PAN": "5204910211482784",
                "ExpMonth": "12",
                "ExpYear": "25"
            },
            "BillingAddress": {
                "Name": "Jane Doe",
                "Line1": "1234 Main St",
                "Line2": "Suite A",
                "City": "Cityville",
                "State": "TX",
                "PostalCode": "75000",
                "Country": "US",
                "Phone": "555-555-5555",
                "Email": "example@example.com"
            }
        }
    },
    "Attributes": {
        "EntryMode": "manual",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true
        }
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2020-03-03T17:01:44"
    },
    "Detail": {
        "MerchantData": {
            "OrderNumber": "22-1111",
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: Retail direct debit (magnetic stripe with PIN)

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "Track2": {
                "Track2": ";5204910211482784=2512901?"
            },
            "PIN": {
                "Data": "E8F5AB34A836C0BB",
                "KSN": "FFFF9876543210E00002"
            }
        }
    },
   "Attributes": {
        "EntryMode": "magstripe",
        "ProcessingSpecifiers": {
            "InitiatedByPOS": true,
            "DebitDirect": true
        }
    },
    "TransactionEntry": {
        "Device": "Ingenico Move/5000",
        "DeviceVersion": "0.0",
        "Application": "EXAMPLE POS App",
        "ApplicationVersion": "0.0",
        "Timestamp": "2021-02-02T14:06:18"
    },
    "Detail": {
        "MerchantData": {
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: Retail (magnetic stripe without PIN)

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "Track2": {
                "Track2": ";5204910211482784=2512901?"
            }
        }
    },
    "Attributes": {
        "EntryMode": "magstripe",
        "ProcessingSpecifiers": {
            "InitiatedByPOS": true
        }
    },
    "TransactionEntry": {
        "Device": "Ingenico Move/5000",
        "DeviceVersion": "0.0",
        "Application": "EXAMPLE POS App",
        "ApplicationVersion": "0.0",
        "Timestamp": "2021-02-02T14:06:18"
    },
    "Detail": {
        "MerchantData": {
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: Restaurant (EMV)

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Tip": 1.00,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "Track2": {
                "Track2": ";4005520000000129=221220118358262?"
            },
            "ICC": {
                "CardSequenceNumber": "000",
                "TerminalCapabilities": "000000",
                "TerminalVerificationResults": "8000010000",
                "UnpredictableNumber": "9BADBCAB",
                "IssuerApplicationData": "0F400102030405060708090A0B0C0D0E",
                "ApplicationCryptogram": "30148FDAF37B80AD",
                "ApplicationTransactionCounter": "00FF",
                "ApplicationInterchangeProfile": "0000",
                "TransactionType": "00",
                "TerminalCountryCode": "0826",
                "TransactionDate": "010101",
                "AmountAuthorized": "000000012300",
                "TransactionCurrencyCode": "0826",
                "AmountOther": "000000000000",
                "FormFactorIndicator": "00000001"
            }
        }
    },
    "Attributes": {
        "EntryMode": "contactless-chip",
        "ProcessingSpecifiers": {
            "InitiatedByPOS": true
        }
    },
    "TransactionEntry": {
        "Device": "Ingenico Move/5000",
        "DeviceVersion": "0.0",
        "Application": "EXAMPLE POS App",
        "ApplicationVersion": "0.0",
        "Timestamp": "2021-02-02T14:06:18"
    },
    "Detail": {
        "MerchantData": {
            "Server": "Server:  Nick",
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: ECommerce Initial Recurring

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 30.00,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "CardPresent": false,
            "CVC": {
                "CVC": "1234"
            },
            "PAN": {
                "PAN": "5204910211482784",
                "ExpMonth": "12",
                "ExpYear": "25"
            },
            "BillingAddress": {
                "Name": "Jane Doe",
                "Line1": "1234 Main St",
                "Line2": "Suite A",
                "City": "Cityville",
                "State": "TX",
                "PostalCode": "75000",
                "Country": "US",
                "Phone": "555-555-5555",
                "Email": "example@example.com"
            }
        }
    },
    "Attributes": {
        "EntryMode": "manual",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true,
            "FirstPayment": true,
            "RecurringPayment": true
        }
    },
    "Recurring": {
        "Frequency": "monthly",
        "PaymentAmountType": "fixed-amount"
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2020-03-03T17:01:44"
    },
    "Detail": {
        "MerchantData": {
            "OrderNumber": "22-1111",
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: ECommerce Subsequent Recurring

Code Sample using CURL

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "TransactionID": "1XSnl0X7GC44qPT2CVV8BCz0bQi",
    "Amount": {
        "Total": 30.00,
        "Currency": "USD"
    },
    "Attributes": {
        "EntryMode": "card-on-file",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true,
            "RecurringPayment": true
        }
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2020-03-03T17:01:44"
    },
    "Detail": {
        "MerchantData": {
            "OrderNumber": "22-1111",
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: eCommerce Using 3DSecure

Permission Required

Use of 3DSecure functionality requires special permission from Paynetworx.

Code Sample using CURL (American Express)

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Fee": 0.50,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "CardPresent": false,
            "CVC": {
                "CVC": "1234"
            },
            "PAN": {
                "PAN": "5204910211482784",
                "ExpMonth": "12",
                "ExpYear": "25"
            },
            "BillingAddress": {
                "Name": "Jane Doe",
                "Line1": "1234 Main St",
                "Line2": "Suite A",
                "City": "Cityville",
                "State": "TX",
                "PostalCode": "75000",
                "Country": "US",
                "Phone": "555-555-5555",
                "Email": "example@example.com"
            },
            "3DSecure": {
                "ECommerceIndicator": "05",
                "AuthenticationValue": "AAABBWcSNIdjeUZThmNHAAAAAAA="
            }
        }
    },
    "Attributes": {
        "EntryMode": "manual",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true
        }
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2020-03-03T17:01:44"
    },
    "Detail": {
        "MerchantData": {
            "OrderNumber": "22-1111",
            "CustomerID": "991111"
        }
    }
}'

Code Sample using CURL (VISA)

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": 5.50,
        "Fee": 0.50,
        "Tax": 0.90,
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "CardPresent": false,
            "CVC": {
                "CVC": "1234"
            },
            "PAN": {
                "PAN": "4012001037141112",
                "ExpMonth": "12",
                "ExpYear": "27"
            },
            "BillingAddress": {
                "Name": "Jane Doe",
                "Line1": "1234 Main St",
                "Line2": "Suite A",
                "City": "Cityville",
                "State": "TX",
                "PostalCode": "75000",
                "Country": "US",
                "Phone": "555-555-5555",
                "Email": "example@example.com"
            },
            "3DSecure": {
                "AuthenticationValue": "0099010618111100000000788400707000000000",
                "ECommerceIndicator": "05"
            }
        }
    },
    "Attributes": {
        "EntryMode": "manual",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true
        }
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2020-03-03T17:01:44"
    },
    "Detail": {
        "MerchantData": {
            "OrderNumber": "22-1111",
            "CustomerID": "991111"
        }
    }
}'

REQUEST Example: eCommerce with corporate card data

This below example shows a large portion of the Corporate Card data for clarity.

Corporate Card data is indicated in the request payload through the Detail.Order.CorporateCustomer field when it is set to true. The Order, Items, ShipTo, ShipFrom, and Shipment objects may be used for Corporate data (CorporatCustomer is true) or for non-corporate data (CorporateCustomer is false or not present in request).

The typical data in request payloads would not contain all of these data fields. For example, requests would include the medical related data fields only when applicable.

Code Sample using CURL (Visa)

URL=https://api.qa.paynetworx.net/v0/transaction/authcapture
HTTPAUTHTOKEN=1fHfjpw86udrDQHRMKabypEmhY4:1fHfkJrOs7iVBnC07HDxCPZuPsK
curl -sS --user $HTTPAUTHTOKEN -H 'Content-Type: application/json' -H "Request-ID: $(ksuid)" $URL -d '
{
    "Amount": {
        "Total": "464.00",
        "Currency": "USD"
    },
    "PaymentMethod": {
        "Card": {
            "CVC": {
                "CVC": "321"
            },
            "PAN": {
                "PAN": "4012001037141112",
                "ExpMonth": "12",
                "ExpYear": "25"
            },
            "BillingAddress": {
                "Name": "Jane Smith",
                "Line1": "9876 Test Loooooooooooooong Lane",
                "Line2": "APT 11235",
                "City": "Testville",
                "State": "TX",
                "PostalCode": "75218",
                "Country": "US"
            }
        }
    },
    "Detail": {
        "Order": {
            "OrderID": "PNX-24",
            "OrderDate": "2024-08-08T07:33:12",
            "Invoice": "321321",
            "CorporateCustomer": true,
            "CustomerPO": "45645678",
            "CustomerANI": "5555551234",
            "CustomerANICallType": "00",
            "CustomerIPAddress": "0.0.0.0.0.0.0.1",
            "CustomerBrowserType": "Chrome",
            "MerchantHostname": "Paynetworx.com",
            "CustomerRegistered": true,
            "CustomerProfileModified":"2024-08-08T07:31:12",
            "NAICSCode": "541234",
            "AdditionalCardAcceptorInformation": "Additional contact and description",
            "MerchantTaxID": "111111111111",
            "AlternateTaxId": "122222222222",
            "AuthorizedContactName": "John Smith",
            "AuthorizedContactPhone": "555-555-5555",
            "AustinTetraNumber": "1",
            "BusinessCertificationType": "sba-small-business",
            "BusinessOwnerType": "female-business-owner",
            "BusinessRacialEthnicType": "native-hawaiian",
            "BusinessType": "limited-liability-company",
            "CardAcceptorVATNumber": "77777777",
            "CorporationVATNumber": "88888888",
            "CustomerVATNumber": "444444444",
            "InvoiceLevelDiscountTreatment": "tax-calculation-post-discount",
            "MerchantEmail": "noreply@paynetworx.com",
            "MerchantReferenceNumber": "9838484877",
            "CustomerCode": "customerAB454",
            "UniqueInvoiceReferenceNumber": "8388838833",
            "UniqueVATInvoiceReferenceNumber": "33838838388"
        },
        "Items": [
                {
                "ItemID": "item-1",
                "ShipmentID": "shipment-1",
                "PackageID": "package-1",
                "ItemOrderDate": "2024-08-08T00:00:00",
                "ItemQuantity": "1",
                "ItemPrice": "500.00",
                "Description": "Copy Paper Bulk by Pallet",
                "ItemMeasurementDescription": "Pallet",
                "ItemMeasurementCategory": "size",
                "NumberOfUnitsInItem": "10",
                "PerUnitPrice": "50.00",
                "PerUnitMeasurementDescription": "Box",
                "PerUnitMeasurementCategory": "pieces",
                "ItemDiscountAmount": "50.00",
                "ItemDiscountRate": "10.0",
                "ItemDiscountTreatment": "abc",
                "ItemDiscountPerLine": "0.00",
                "CategoryCode": "Office Supplies",
                "ProductCode": "56749",
                "ProductItemNumber": "546749-152",
                "CommodityCode": "12143",
                "ContractNumber": "AB44558-111",
                "HealthcareEligible": false,
                "TaxExempt": false,
                "TaxAmount": "0.00",
                "TaxRate": "0.00",
                "VATTaxAmount": "0.00",
                "VATTaxRate": "0.0",
                "VATTaxForFreightShippingAmount": "0.0",
                "VATTaxFreightShippingRate": "0.0",
                "AlternateTaxAmount": "0.0",
                "ItemExtendedAmount": "0.0",
                "ItemShippingAmount": "0.0",
                "ItemIncentiveAmount": "0.0",
                "Promotional": [
                    {
                        "PromotionStartDate": "2024-08-07T00:00:00",
                        "PromotionEndDate": "2024-08-10T00:00:00",
                        "PromotionalCode": "AUG10TIME"
                    }
                ],
                "MedicalServicePriceAdjustment": "rebill",
                "MedicalServiceProductNumberQualifier": "101",
                "MedicalServiceShiptoHealthIndustryNumber": "C853"
            },
            {
                "ItemID": "item-2",
                "ShipmentID": "shipment-1",
                "PackageID": "package-1",
                "ItemOrderDate": "2024-08-08T00:00:00",
                "ItemQuantity": "1",
                "ItemPrice": "80.00",
                "Description": "Ink Pens By Case",
                "ItemMeasurementDescription": "Case",
                "ItemMeasurementCategory": "size",
                "NumberOfUnitsInItem": "8",
                "PerUnitPrice": "10.00",
                "PerUnitMeasurementDescription": "Box",
                "PerUnitMeasurementCategory": "parts",
                "ItemDiscountAmount": "2.00",
                "ItemDiscountRate": "20.0",
                "ItemDiscountTreatment": "abc",
                "CategoryCode": "Office Supplies",
                "ProductCode": "56749",
                "ProductItemNumber": "546749-152",
                "CommodityCode": "12143",
                "ContractNumber": "AB44558-111",
                "HealthcareEligible": false,
                "TaxExempt": false,
                "TaxAmount": "0.00",
                "TaxRate": "0.00",
                "VATTaxAmount": "0.00",
                "VATTaxRate": "0.0",
                "VATTaxForFreightShippingAmount": "0.0",
                "VATTaxFreightShippingRate": "0.0",
                "AlternateTaxAmount": "0.0",
                "ItemExtendedAmount": "0.0",
                "ItemShippingAmount": "0.0",
                "ItemIncentiveAmount": "0.0",
                "Promotional": [
                    {
                        "PromotionStartDate": "2024-08-08T00:00:00",
                        "PromotionEndDate": "2024-08-08T00:00:00",
                        "PromotionalCode": "YXP20N73859"
                    }
                ],
                "MedicalServicePriceAdjustment": "rebill",
                "MedicalServiceProductNumberQualifier": "101",
                "MedicalServiceShiptoHealthIndustryNumber": "C853"
            }
        ],
        "ShipFrom": {
                "Name": "Paynetworx",
                "Line1": "100 MAIN ST",
                "Line2": "SUITE 11235",
                "City": "Testville",
                "State": "TX",
                "PostalCode": "85054",
                "Country": "US",
                "Phone": "5555557878",
                "Email": "NOREPLY@PAYNETWORX.COM"
        },
        "ShipTo": {
                "Name": "JANE SMITH",
                "Line1": "18850 N 56 ST APT301",
                "Line2": "APT 11235",
                "City": "Testville",
                "State": "TX",
                "PostalCode": "85054",
                "Country": "US",
                "Phone": "6234928872",
                "Email": "JANESMITH@CLEARCHANNEL.COM"
        },
        "Shipment": [
        {
            "ShipmentID": "shipment-1",
            "ShipperName": "UPS",
            "ShipperAddress": {
                "State": "TX",
                "PostalCode": "85054",
                "Country": "US"
            },
            "NumberOfPackages": 1,
            "Package": [
                {
                "PackageID": "package-1-1",
                "ItemID": [
                    "item-2"
                ],
                "PackageWeight": "5.25",
                "PackageShippingAmount": "6.95"
                }
            ],
            "ShippingMethod": "overnight",
            "TrackingNumber": "tn8384839874938343",
            "ShipDate": "2024-08-08T00:00:00",
            "PickupDate": "2024-08-08T02:00:00",
            "DeliveryDate": "2024-08-08T04:00:00",
            "AdditionalInformation": "Shipment pickup"
        },
        {
            "ShipmentID": "shipment-2",
            "ShipperName": "UPS",
            "ShipperAddress": {
                "State": "TX",
                "PostalCode": "85054",
                "Country": "US"
            },
            "NumberOfPackages": 2,
            "Package": [
                {
                "PackageID": "package-2-1",
                "ItemID": [
                    "item-1"
                ],
                "PackageWeight": "255.25",
                "PackageShippingAmount": "40.95"
                },
                {
                "PackageID": "package-2-2",
                "ItemID": [
                    "item-1"
                ],
                "PackageWeight": "255.25",
                "PackageShippingAmount": "40.95"
                }
            ],
            "ShippingMethod": "ground",
            "TrackingNumber": "tn33849384922222",
            "ShipDate": "2024-08-08T00:00:00",
            "PickupDate": "2024-08-08T02:00:00",
            "DeliveryDate": "2024-08-08T04:00:00",
            "AdditionalInformation": "Shipment pickup"
        }
        ]
    },
    "Attributes": {
        "EntryMode": "manual",
        "ProcessingSpecifiers": {
            "InitiatedByECommerce": true
        }
    },
    "TransactionEntry": {
        "Device": "NA",
        "DeviceVersion": "NA",
        "Application": "Merchant Website Express",
        "ApplicationVersion": "1.0",
        "Timestamp": "2024-08-08T07:34:44"
    }
}'

RESPONSE Object Attributes

defaultResponseTable
Attribute	Data Type	Description
TransactionID	ksuid	Unique transaction lifetime system ID
EventID	ksuid	Unique transaction event system ID
RequestID	ksuid	Unique transaction request system ID
Approved	boolean	Request approval indicator
Token	object	Request approval indicator
TokenID	ksuid	Token ID TokenID is aKey/Value of the "Token" Object.
TokenName	string	Unique Name of the Token Used TokenName is aKey/Value of the "Token" Object.
AddressLine1Check	string	Address verification result (pass, fail, unavailable, unchecked)
AddressZipCheck	string	Postal code verification result (pass, fail, unavailable, unchecked)
CVCCheck	string	CVC result (pass, fail, unavailable, unchecked)
CVCCheckResultCode	string	Letter Code (returned from the card association)

RESPONSE Example

JSON Response Object

json

{
  "TransactionID": "1XSnl0X7GC44qPT2CVV8BCz0bQi",
  "EventID": "1XSnvq7J5ggxZg70sWuRg4kEBcu",
  "RequestID": "1XSnzEjZ4IBh5Nj0OEVPTWpwYo8",
  "Approved": true,
  "AddressLine1Check": "pass",
  "AddressZipCheck": "pass",
  "CVCCheck": "pass"
}

AUTHCAPTURE ​

Available Functions ​

Perform an 'authcapture' transaction ​

REQUEST Object Attributes ​

REQUEST Object Non-Required Attributes ​

REQUEST Example: eCommerce ​

REQUEST Example: Retail direct debit (magnetic stripe with PIN) ​

REQUEST Example: Retail (magnetic stripe without PIN) ​

REQUEST Example: Restaurant (EMV) ​

REQUEST Example: ECommerce Initial Recurring ​

REQUEST Example: ECommerce Subsequent Recurring ​

REQUEST Example: eCommerce Using 3DSecure ​

REQUEST Example: eCommerce with corporate card data ​

RESPONSE Object Attributes ​

RESPONSE Example ​

AUTHCAPTURE

Available Functions

Perform an 'authcapture' transaction

REQUEST Object Attributes

REQUEST Object Non-Required Attributes

REQUEST Example: eCommerce

REQUEST Example: Retail direct debit (magnetic stripe with PIN)

REQUEST Example: Retail (magnetic stripe without PIN)

REQUEST Example: Restaurant (EMV)

REQUEST Example: ECommerce Initial Recurring

REQUEST Example: ECommerce Subsequent Recurring

REQUEST Example: eCommerce Using 3DSecure

REQUEST Example: eCommerce with corporate card data

RESPONSE Object Attributes

RESPONSE Example