The API request consists of four steps:
Method,
URL,
Header and
Body.
1.1 Method
Request Method:
POST
1.2 URL
The API is accessed from the Request URL. This is a combination of our URL and the addition of the following text at the end of the URL:
“/v1/authorization/”
URL For Stage Environment:
httpss://stage-gateway.isignthis.com/v1/authorization/
URL For Production Environment:
httpss://gateway.isignthis.com/v1/authorization/
1.3 Header
Fill in the appropriate header information. The API Header information is provided by the iSignthis Merchant Support team.
Field Name |
Field Value |
From |
API client name |
Authorization |
Bearer API token |
Content_type |
application/json |
Example:
Field Name |
Field Value |
From |
Test_APIClient |
Authorization |
Bearer TEXnkvZCtFucXebHYwrYLIGbkhjygvBTbxWELCCnCQJTKsx6bYNh5fOjEE |
Content_type |
application/json |
1.4 Body
In order to generate the
“Transaction API call” the following
API Objects are required. Each object has a number of specific attributes in order to be successful.
Below you can view each object name, description and whether is required or not. Also, the glossary column has a link that directs you to detailed information about each object, including examples.
NOTE : *Cardholder object is only applicable if you have card numbers entered on your own payment page (Server to Server). You must be PCI certified to do this. iSignthis will need to review and approve the PCI documents in order to allow Server to Server integration.
In the API body request you need to add the “workflow name” and the“id” in the “merchant” object with the ones provided by merchant support.
“
Test_Workflow” text should be replaced with the
“workflow name” provided by iSignthis Merchant support team.
“workflow”:”Test_Workflow”
“Test_Merchant” text should be replaced with the “merchant_id” provided by iSignthis Merchant support team.
“id”:”Test_Merchant”
The API call consists of required fields to proceed with the payment:
– first_name
– last_name
– email
– mobile
– billing_address_street
– billing_address_street_number
– billing_address_city
– billing_address_postal_code
– billing_address_country
Please take a look at the JSON code with the title “Sample JSON body for Acquiring” provided for reference.
NOTE: In the “account” object – identifier is the customer ID that you assigned to your customer. Each “identifier” must be unique and paired with the customer for future transactions.