FAQs
- Home
- FAQs
Frequently Asked Questions
API Client Name, Bearer API Token, Content type
Stage Environment: https://stage-gateway.isignthis.com/v1/authorization/
Production Environment: https://gateway.isignthis.com/v1/authorization/
Navigate to the Getting Started page for more information.
The API Header information such as API Client Name, Bearer API Token and Content type are provided by the iSignthis Merchant Support team.
Acquiring (Required fields)
The API call requires information about billing address 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
Paydentity (Required fields)
The API call requires additional information of the end user from the cardholder such as residential address to proceed with the payment.
– first_name
– last_name
– dob
– gender
– email
– mobile
– billing_address_street
– billing_address_street_number
– billing_address_city
– billing_address_postal_code
– billing_address_country
– residential_address_street
– residential_address_street_number
– residential_address_city
– residential_address_postal_code
– residential_address_subdivision (US,AU,CA)
– residential_address_country
– citizen_country
Additional parameters are mandatory based on country:
US, AU, CA – residential_address_subdivision Valid state (for countries that have states)
Information about the required fields are also provided in the Client Object.
Field | Format |
first_name | Only 24 characters allowed without special characters (maximum length of 255 chars.) |
dob | YYYY-mm-dd |
mobile | E.123 Mobile should be within 5-15 characters (including prefix code) No spaces allowed. |
phone_number | E.123 Mobile should be within 5-15 characters (including prefix code) No spaces allowed. |
billing_address_street | Only 24 characters allowed without special characters (maximum length of 255 chars.) |
residential_address_street | Only 24 characters allowed without special characters (maximum length of 255 chars.) |
All the required information in the transaction is sent to the notification URL provided.
Navigate to the Notifications page for more information.
Request URL: POST/v1/tasks/ID/accept
Request URL: POST /v1/tasks/ID/reject
For more details navigate to the Actions page.
Request URL: POST /v1/transaction/iSignthis-transaction-ID/cancel
For more details navigate to the Actions page.
Navigate to the Supported Languages page.
The event field describes a system action that has been triggered, either automatically or by an operator.
The state field by itself is the overall reported state of the transaction and should be the only field that third parties take any action on.
The compound state is a combination of the state appended with a reason. This field is informational only and is subject to change without notice.
The filtered state (if specified) will be used when required by the end user’s browser.