2. Authorization Transaction

Authorize a payment for a given quote. The final step for processing a transaction. Requires that you've already obtained a quote that's still active.

POST Request to {Endpoint}/pay/submitTransaction

submitTransaction can only be called once a quote has been generated and is active, meaning that the quote was generated within 10 minutes of the request to authorize a payment.

When a payment is authorized for a given quote, the user's billing information is processed for the orderTotal amount generated in getQuote.

Parameter	Type	Details
token	String	Quote token generated in Step 1
ipAddress	String	User's IP address
email	String	Email address

Payment Information:

Parameter	Type	Details
​paymentInformation	Object	​Payment details
cardNumber	Number	User's card number
cardHolderName	String	User's card name
CVV	Number	User's card CVV
monthExpire	Number	User's card expiry month
yearExpire	Number	User's card expiry year
billingAddress	String	Billing Address
city	String	User's city
state	String	User's state
country	String	User's country
zip	String	Zip code

JSON body request example:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjaGFudElEIjoiOTUiLCJvcmRlckFtb3VudCI6IjEwLjAxIiwib3JkZXJUb3RhbCI6MTAuOTUsInRva2VuRXhwaXJlIjoiNjAwIiwiaWF0IjoxNjg5Mzc0MjEzLCJleHAiOjE2ODkzNzQ4MTN9.9Oa8aEW3ifbT-TC9MLvAg_cjf2jdufiUODBYhkBjR5k",
  "paymentInformation": {
    "cardNumber": "4111111111111111",
    "cardHolderName": "John Doe",
    "CVV": "123",
    "monthExpire": "11",
    "yearExpire": "25",
    "billingAddress": "123 Main St",
    "billingAddress2": "Apt 4B",
    "city": "Mexico City",
    "state": "CO",
    "country": "MX",
    "zip": "96002"
  },
  "ipAddress": "192.168.37.89",
  "email": "[email protected]"
}

Successful Response:

{
    "success": true,
    "data": {
        "paymentApproved": true,
        "nftStatus": "CONFIRMING",
        "txID": 141840,
        "orderTotal": 11.61,
        "mintHash": "",
        "mintDate": ""
    }
}

In case of authorization 2D/3D transaction failure, the response will be:

{
   success: false,
   message: 'Card data is incomplete/invalid'
 }