Type Definitions
AuthenticateConsumerRequest
A representation of the entered payment details and details of the consumer's browser attributes required for strong authentication of a payment transaction using 3D Secure or equivalent. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
AuthenticationChallengeResult
A representation of an attempted authentication of the consumer for a payment transaction,
which requires the consumer to complete an additional authentication challenge as part of the strong consumer authentication process using 3D Secure.
Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
AuthenticationFailureResult
A representation of a failed authentication of the consumer for a payment transaction using 3D Secure.
The consumer should be informed of the authentication failure and asked to enter the details of another card upon
receiving a failure authentication result or the payment transaction should be abandoned so no authorization is attempted.
Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
AuthenticationSuccessResult
A representation of the successful authentication of the consumer for a payment transaction using 3D Secure.
The payment for the payment transaction should be authorized upon receiving a successful authentication result.
Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
AuthorizePaymentResponse
A representation of the details for the successful authorization of a payment transaction. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
BaseConfig
Base configuration for all requests made to the Payment Gateway APIs.
Type:
- Object
Properties:
| Name | Type | Description |
|---|---|---|
merchantId |
Integer | Transpayrent's unique ID for the merchant. |
sessionId |
Long | Transpayrent's unique ID for the payment session that was returned as the |
accessToken |
String | The access token for the payment session that was returned in the HTTP Header: |
- Source:
CreatePaymentTransactionRequest
A representation of the consumer's payment transaction. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
CreatePaymentTransactionResponse
A simplified representation of the created payment transaction. Please refer to the online documentation for details on the object properties.
Type:
- Object
IFrameConfig
Configuration for the constructed iframe element which will be used to display the authentication challenge.
Type:
- Object
Properties:
| Name | Type | Description |
|---|---|---|
container |
Element | The container element in which the constructed iframe will be displayed. Defaults to |
css |
String | Optional CSS class(es) that will be applied to the constructed iframe. |
callback |
String | An optional callback function which will be invoked just before the authentication challenge is initiated and just after the challenge is completed.
The callback function accepts 2 arguments:
- event: The event that triggered the callback, will be either |
- Source:
Example
Example callback function
function (event, iframe) {
switch (event) {
case 'authentication-challenge-initiated':
// DO SOMETHING BEFORE THE AUTHENTICATION CHALLENGE IS DISPLAYED
break;
case 'authentication-challenge-completed':
// DO SOMETHING AFTER THE AUTHENTICATION CHALLENGE IS COMPLETE
break;
}
InitializeAuthenticationRequest
A representation of the payment details provided by the consumer for strong authentication of a payment transaction using 3D Secure or equivalent. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
InitializeAuthenticationResponse
A representation of the details required to progress the 3D Secure process for strong consumer authentication. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
PAYMENT_METHOD_ID
The unique id for the payment method (AMEX, MasterCard, VISA etc.). Please refer to the online documentation for details on the object properties.
Type:
- Enum
- Source:
- See:
PaymentCard
A representation of a payment made using a payment card such as a MasterCard credit card or a VISA debit card. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
SaveConsumerValuableRequest
A representation of the payment details for the payment instrument, such as a MasterCard credit card or a VISA debit card, which will be saved. Please refer to the online documentation for details on the object properties.
Type:
- Object
- Source:
- See:
SaveConsumerValuableResponse
A representation of the details for successfully saving the provided payment card. Please refer to the online documentation for details on the object properties.
Type:
- Object
Status
A status response returned by the Payment Gateway when an API request fails.
Type:
- Object
Properties:
| Name | Type | Description |
|---|---|---|
api |
String | The Payment Gateway API that returned the message(s). |
status |
Integer | The HTTP Status Code returned by the Payment Gateway. |
messages |
Array.<StatusMessage> | A list of messages returned by the Payment Gateway. |
- Source:
StatusMessage
A representation of a status message returned by the Transpayrent Payment Gateway.
Type:
- Object
- Source:
- See: