T-Lync Service
T-Lync service from Tadawul digital solution provider
Pay
Pay the transaction.
Confirm (Pay)
POST
https://api.plutus.ly/api/v1/transaction/tlync/confirm
Pay the transaction
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer: [Access token] |
X-API-KEY* | String | API Key |
Request Body
Name | Type | Description |
---|---|---|
amount* | String | Transaction amount in Libyan dinars. Formatting is allowed with a maximum of two decimal places: XXX, XX.X, XX.XX |
invoice_no* | String | Invoice number associated with transaction |
mobile_number* | String | Valid mobile number format start with 9x or 09 |
String | [Optional] Email address | |
return_url* | String | URL after payment is completed to allow the customer to return to the order/invoice |
callback_url* | String | The URL of your Instant update Server URL to track your order/invoice, instantly sent by Plutu when the transaction is complete. This URL must be publicly accessible; private and localhost URLs are not supported. |
customer_ip | String | [Optional] Customer IP address |
lang | String | [Optional] ar or en, by default ar |
Callback handler
The callback will be received from Plutu when the transaction is completed. This gives a Merchant better control of how the transaction is processed on the Merchant's side. This is useful e.g. when you want to mark an order as paid, update your shop's inventory, or add appropriate records to Merchant’s internal accounting system.
Callback parameters:
The callback is called with HTTP POST as JSON
Parameter | Description |
---|---|
gateway | Gateway name: tlync |
approved | Transaction completed |
invoice_no | Invoice number sent in the pay request |
amount | amount sent in the request |
paymet_method | The payment method in which the transaction was completed on T-Lync. Supported payment methods: tadawul, edfaly, sadad, mobicash, and moamalat |
transaction_id | Plutu transaction id |
hashed | Hash message authorization code (HMAC) is used to verify both the data integrity and the authorization of a message. |
Return handler
Once the payment has been completed client can be redirected to the merchant-provided return URL.
Return parameters:
The callback is called with HTTP GET and with the same query string parameters as in the redirect
Parameter | Description |
---|---|
approved | Transaction completed |
invoice_no | Invoice number sent in the pay request |
hashed | Hash message authorization code (HMAC) is used to verify both the data integrity and the authorization of a message. |
SHA-256 HMAC is calculated as follows:
The SHA-256 HMAC calculation includes all response parameters and key-value pairs except the “hashed” parameter.
Create an SHA-256 HMAC of the resultant string using the secret key created in the Plutu account and convert it to uppercase and compare it with the “hashed” parameter received in the callback or return handler.
Last updated