Authorization

The Auth method initializes an authorization-only transaction. Authorization-only transactions are not included in the batch for settlement.

A separate capture request must be submitted in order for the transaction to be settled.

The suggested authorization period is 10 days. You need to capture a payment within the authorization period to collect the funds of the transaction. Note, the authorization period can vary by issuer and/or card brand, it is your responsibility to ensure whatever window period is appropriate for your use case.

It is important to note that these requests need to always include the system terminal.id for which you are making a payment.

Object

Fields	Description	Type	Filterable	Required	Readonly	Level 1	Level 2	Level 3
id	Unique ID of the payment record	Integer	Yes	No	Yes	No	No	No
terminal	Terminal Object	Object	No	Yes	No
terminal.id	Dashboard Terminal ID	Integer	Yes	Yes	No	Yes	Yes	Yes
amount	Payment amount	Number	No	Yes	No	Yes	Yes	Yes
source	Transaction source `Internet`, `Phone` and `Mail`	ENUM	Yes	Yes	No	Yes	Yes	Yes
origin	Origin of the transaction (i.e. Website, CRM, etc)	String	Yes	No	No	No	No	No
level	Desired level of the payment `1`, `2` or `3`	ENUM	Yes	Yes	No	Yes	Yes	No
threeds	3DS Object	Object	No	Yes	No
threeds.id	The ID that is returned from the 3DS response	Integer	No	Yes	No	Yes	Yes	Yes
card	Card details	Object	No	Yes	No
card.name	Cardholder name	String	No	Conditional	No	Yes	Yes	Yes
card.number	Card number	Integer	No	Conditional	No	Yes	Yes	Yes
card.cvv	Card security code / CVV	Integer	No	Conditional	No	Yes	Yes	Yes
card.exp	Card expiration date /Format: mm/yy	String	No	Conditional	No	Yes	Yes	Yes
card.save	Save the card details for future use `Yes` or `No`. This will return a token	ENUM	No	No	No	No	No	No
card.store	`Yes` or `No`. This indicates if the transaction is a Card On File (COF) or Merchant Initiated Transaction (MIT) type. For use with Visa only	ENUM	No	No	No	No	No	No
card.token	Card token. This is used for saved card and for future billing.	String	No	Conditional	No	No	No	No
card.verification	Verification object	Object	No	No	Yes
card.verification.cvv	The card security code verification response.	String	No	No	Yes	No	No	No
card.verification.address	The Address Verification System response.	String	No	No	Yes	No	No	No
card.address	Card billing address details	Object	No	No	No
card.address.country	Card billing country	String	No	No	No	Yes	Yes	Yes
card.address.state	Card billing state	String	No	No	No	Yes	Yes	Yes
card.address.city	Card billing city	String	No	No	No	Yes	Yes	Yes
card.address.street	Card billing street	String	No	No	No	Yes	Yes	Yes
card.address.zip	Card billing zip	String	No	No	No	Yes	Yes	Yes
card.networkTransactionId	This field is a unique network transaction identifier for all card types. If used in consecutive Visa/Mastercard transactions, it indicates the transaction is being processed using a card in the customer wallet.	String	No	No	Yes	Yes	Yes	Yes
contact	Contact object	Object	No	No	No
contact.name	Contact name	String	No	No	No	No	No	No
contact.phone	Contact phone	String	No	No	No	No	No	No
contact.email	Contact email	String	No	No	No	No	No	No
sendReceipt	Send receipt on `Sale` or `Capture` action. This parameter requires `contact.email` to be provided. `Yes` or `No`.	ENUM	No	No	No	No	No	No
externalId	Unique record identifiers from a system outside of Payment Gateway	String	Yes	No	No	No	No	No
isRecurring	Set this flag to `Yes` if the payment request comes from a recurring system	Boolean	No	No	No	No	No	No
split	If this is a split Tender transaction. This will return an ID that needs to be provided in the next sequence	`Yes` or `No`	String	No	No	No	Yes	Yes
ip	IP Object	Object	No	No	No
ip.address	Cardholder IP address	String	Yes	No	No	No	No	No
ip.isp	Internet Service Provider	String	No	No	No	No	No	No
ip.type	The type of the IP	String	No	No	No	No	No	No
ip.location	IP location Object	Object	No	No	No
ip.location.city	City	String	No	No	No	No	No	No
ip.location.state	State	String	No	No	No	No	No	No
ip.location.country	Country	String	No	No	No	No	No	No
ip.location.zip	ZIP Code	String	No	No	No	No	No	No
ip.info	Info	Object	No	No	No
ip.info.isAnonymous	Anonymous Check	Boolean	No	No	No	No	No	No
ip.info.isAnonymousVpn	Anonymous VPN	Boolean	No	No	No	No	No	No
ip.info.isPublicProxy	Public Proxy	Boolean	No	No	No	No	No	No
ip.info.isHostingProvider	Hosting Provider IP	Boolean	No	No	No	No	No	No
ip.info.isTorExitNode	Tor Exit Node of the IP	Boolean	No	No	No	No	No	No
order	Order details	Object	No	No	No
order.id	Purchase order	String	No	No	No	No	Yes	Yes
order.date	Purchase order date	Date	No	No	No	No	No	Yes
order.invoice	Order invoice number	String	No	No	No	No	No	Yes
order.summaryCommodityCode	The international description code of the overall goods/services being supplied.	String	No	No	No	No	No	Yes
order.description	Also referred to as Soft Descriptor. The text on the cardholder's statement that describes the purchase. If the order.description is sent, it will be forwarded in the authorization and capture for all card types.	String	No	No	No	No	Yes	Yes
order.supplierRefNo	Supplier reference number	String	No	No	No	No	Yes	No
order.customer	Customer details	Object	No	No	No
order.customer.identifier	Customer reference identifier	String	No	No	No	No	No	No
order.customer.vat	Customer's government assigned tax identification number	String	No	No	No	No	No	No
order.shipping	Order shipping details	Object	No	No	No
order.shipping.fromZip	Shipping from zip code	String	No	No	No	No	No	Yes
order.shipping.toZip	Destination zip code	String	No	No	No	No	Yes	Yes
order.shipping.toCountry	Destination county code	String	No	No	No	No	No	Yes
order.shipping.cost	Shipping cost	Number	No	No	No	No	No	Yes
order.shipping.dutyCost	Shipping duty cost	Number	No	No	No	No	No	Yes
order.tax	Order tax details	Object	No	No	No
order.tax.amount	Sales tax	Number	No	No	No	No	Yes	Yes
order.tax.details	Additional sales tax information	Array	No	No	No
order.tax.details.type	The type of sales tax applied	String	No	No	No	No	No	Yes
order.tax.details.amount	The sales tax amount applied to the order	Number	No	No	No	No	No	Yes
order.tax.details.rate	Tax rate (Allowed range 0.01-100)	Number	No	No	No	No	No	Yes
order.tax.details.category	`Service`, `Duty`, `VAT`, `Alternate`, `National` `TaxExempt`	ENUM	No	No	No	No	No	Yes
order.products	Array containing product objects. [Description of product object is shown below]	Array	No	No	No
order.discounts	Order discounts details	Object	No	No	No
order.discounts.amount	Discounts amount	Number	No	No	No	No	No	Yes
order.discounts.details	Discount	Object	No	No	No
order.discounts.details.name	Discount name	String	No	No	No	No	No	Yes
order.discounts.details.amount	Discount amount	Number	No	No	No	No	No	Yes
order.discounts.details.percentage	Discount percentage	Number	No	No	No	No	No	Yes
order.discounts.details.priority	Discount priority	Integer	No	No	No	No	No	Yes
feeTransaction	In cases where a fee is run as a separate transaction on another terminal	Object	No	No	Yes
feeTransaction.id	Fee Transaction ID	Integer	No	No	Yes	No	No	No
feeTransaction.type	The type of sales tax applied	String	No	No	Yes	No	No	No
feeTransaction.amount	The sales tax amount applied to the order	Number	No	No	Yes	No	No	No
batch	Object	Object	No	No	Yes
batch.id	Batch ID	Integer	Yes	No	Yes	No	No	No
batch.number	Batch Number	Integer	No	No	Yes	No	No	No
batch.batchedOn	Date when batch was generated	Datetime	No	No	Yes	No	No	No
status	Status Object	Object	No	No	Yes
status.status	Status	String	Yes	No	Yes	No	No	No
status.reason	Description	String	No	No	Yes	No	No	No

If you pass the level parameter in your request, we will validate the field requirements of the level you have requested. In the event of an incomplete validation we will return an error with the missing fields.

If a transaction has a batch information in the response, this means that this transaction has batched.

Products Object

Fields	Description	Type	Filterable	Required	Readonly	Level 1	Level 2	Level 3
id	Product ID	String	No	No	No	No	No	Yes
name	Product Name	String	No	No	No	No	No	Yes
price	Product Price	Number	No	No	No	No	No	Yes
quantity	Product Quantity	Integer	No	No	No	No	No	Yes
measurementUnit	Product Measurment Unit	String	No	No	No	No	No	Yes
commodityCode	Product commodity code. It should contain a maximum of 12 characters. Only letters, numbers and space are allowed	String	No	No	No	No	No	Yes

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

application/json

Body

Example

{
    "id": 876,
    "amount": "1.99",
    "origin": null,
    "type": "Auth",
    "level": 1,
    "authCode": "VTLMC1",
    "parent": {
        "id": null
    },
    "terminal": {
        "id": 24
    },
    "threeds": {
        "id": null
    },
    "card": {
        "bin": 530957,
        "name": "John Wick",
        "number": 2257,
        "exp": "2030-12-31",
        "verification": {
            "cvv": "M",
            "address": "Y"
        },
        "networkTransactionId": "1212MCC111863**"
    },
    "contact": {
        "name": null,
        "phone": null,
        "email": "test@testemail.com"
    },
    "externalId": null,
    "isRecurring": "No",
    "split": null,
    "refunded": false,
    "captured": false,
    "history": [],
    "order": null,
    "feeTransaction": null,
    "batch": {
        "id": null,
        "number": null,
        "batchedOn": null
    },
    "ip": {
        "address": "173.239.211.183",
        "isp": "Ipxo Limited",
        "type": "hosting",
        "location": {
            "city": "New York",
            "state": "NY",
            "country": "US",
            "zip": "10118"
        },
        "info": {
            "isAnonymous": "Yes",
            "isAnonymousVpn": "No",
            "isPublicProxy": "No",
            "isHostingProvider": "No",
            "isTorExitNode": "No"
        }
    },
    "status": {
        "status": "Approved",
        "reason": null
    },
    "updatedOn": "2023-05-09 15:23:44",
    "createdOn": "2023-05-09 15:23:44"
}

Request

Request Code Samples

Responses