API Reference

Initiate Order

post
https://api.dev-taly.io/accounts/payment/v2/initiate

Initiate Order

📘

in case you sent a duplicated order for your merchant which you have sent to us in a previous create order request you will get an error, check it in API response

Body Params
string
required
Defaults to M-900001

For every order the merchant order ID should be unique.

string
Defaults to en

Default is set to English if not passed, supported languages EN & AR.

float
Defaults to 2

basket amount three decimals format.

float
required
Defaults to 2.5

Total amount to be charged to the customer, including the discounts & taxes & delivery fees three decimals format.

string
required
Defaults to KWD

The three-letter ISO currency code e.g KWD.

float
Defaults to 0

if the there is discount applied on the order three decimals format.

float
Defaults to 0

you can pass it as "0" if the taxes are not applied in your country.

float
Defaults to 0.5

you can pass it as "0" if there are no delivery fees, otherwise pass it as 3 decimals

string
Defaults to home delivery

Delivery or Pickup

float
Defaults to 0

if there is any other fees applied on the order (3 decimals) if not then no need to pass it

string
required
Defaults to https://yourmerchant.com/checkout/

The merchant redirection URL is used to send the customer back to your website after completing the payment, along with the final order status: Success if the order was placed successfully, Cancelled if the customer aborted the transaction, and Failure if the payment failed.

string
required
Defaults to https://yourmerchant.com/yourWebwebhookEndpoint/

Once the payment is completed Taly will be sending the status on the webhook endpoint URL

string
Defaults to https://www.adidas.com/on/demandware.static/Sites-adidas-MLT-Site/-/default/dwe6fed0d0/images/adidas_logo.svg

URL of the sub-merchant logo (max 256 characters) logo dimension must be 250px x 250px

string
Defaults to Magento

for direct integration through our APIs then the platform will be website for the plugins send the plugin name e.g WooCommerce - Shopify - Magento ...etc (max 64 characters)

PSP
object

Conditional mandatory for PSP only (Data type: string): will be provided by the payment aggregator which saved in their database

customerDetails
object
required

We need the customer details to process the transaction.

deliveryAddress
object
orderItems
array of objects
required

We request order items for better experience.

orderItems*
Responses

Updated 12 months ago

What’s Next

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 months ago

What’s Next

Did this page help you?