Login As Guest And Redirect
Description¶
The loginAsGuestRoleThirdpartyAndRedirect endpoint is used to login as guest and redirect the user to the make a payment page.
Request¶
Endpoint
/v1/loginAsGuestRoleThirdpartyAndRedirect
Method
GET
Attributes
| ELEMENT | DESCRIPTION | FORMAT |
|---|---|---|
| merchantCode | Required The unique code used for the respective merchant. |
Ex: VELA |
| returnURL | Required The Return URL must be in Base64 Encoded to accommodate '+', '/' and '=' characters into special percent-encoded hexadecimal sequences. Upon successful completion, the user will be redirected to this URL with payment response. Upon failure, the user will be redirected to the Originated page. |
Ex: http://whatever.xyzcompany.com/return?invoiceId=AB-123-X-12345&subscriptionId=1248abc&status=OK&signature=4d30141ab0a7416c308b62d56e52dfeaf25b7 684cedf9e11082ac6bdbf84ee98 The Signature will include the Merchant Secret Key + Invoice Number + SubscriptionId + status + Error Code with a semicolon(;) as a delimiter. The value of status is 'OK' for approved transactions and 'KO' for declined/failed transactions. errorCode: If the status’ is 'KO', include the reason for the failure. Ex: 'E452' Signature = sha-256(Merchant's Secret Key + ';' + invoiceNumber + ';' + subscriptionId + ';' + status + ';' + errorCode) |
| invoiceNumber | Required Invoice number related to the payment. |
Ex: 123456 |
| bookingNumber | Required Booking number related to the payment. |
Ex: 123456 |
| paymentAction | Required Possible values: SALE, PRE_AUTHORIZATION, ZERO_DOLLAR_AUTH |
Ex: SALE, PRE_AUTHORIZATION, ZERO_DOLLAR_AUTH |
| amount | Required Transaction Amount |
Ex: 100.00 |
| env | Required The environment on which the redirection occurs |
Ex: TEST or PROD |
| signature | Required The Signature will include the VELA Secret Key + Booking Number + Invoice Number with a semicolon(;) as a delimiter. |
Test Environment: Value is iVGZoMkXRi7tG7JB NOTE: For Merchant Specific Secret Key or Custom Secret Key, please contact vela@datumsoftware.com. Production Environment: To Obtain the Production VELA Secret Key, please contact vela@datumsoftware.com |
Given all the details as above, the request Endpoint would appear as follows:
<BASE_URL>/ui/v1/loginAsGuestRoleThirdpartyAndRedirect?merchantCode=VELA&bookingNumber=123456&invoiceNumber=123456&paymentAction=SALE&amount=100.00&returnURL=/confirmation&env=TEST&signature=dfa7df0e1d1862d02ab9e4402a822d0b97f5be505a4f9c1a34539eac346b6148
Note
BASE_URL is derived from the merchantCode.
For Test Environment, the BASE_URL will be "https://vela.datumsoftware.com"
For Production Environment, to Obtain the BASE_URL, please contact vela@datumsoftware.com.
Response¶
"The User will be redirected to the Make a payment page of the respective merchant."
Updated As Of Version 4.1.0.0