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.

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.