Orders
API's to manage Orders.
Last updated
API's to manage Orders.
Last updated
Production URL: https://orders-v1-api-rdqehkur6a-ey.a.run.app
Please Note: If you want to pre-populate user data for the Stripe Onramp payment feature - Please ensure to add the customerInformation object data.
WARNING: Ensure that your system accepts payments ONLY when the status of the notifyUrl request is "success".
POST https://your-notify-url
orderId*
string
TygaPay Order Id.
orderNumber*
string
Unique Order Number .
status*
string
Status of the order upon completion:
success: Payment has been successfully processed.
expired: The order has expired.
cancelled: The order has been cancelled.
date*
string
Order complettion date. i.e
2024-01-07T19:05:30.175Z
amount
number
The paid amount. Amount will only be present if the status is equal to success.
currency
string
i.e USDT, KRU etc
Currency will only be present if the status is equal to success.
txId
String
The payment TygaPay txId. TxID will only be present if the status is equal to success.
When an order receives a final outcome, the Payment Gateway will redirect to the specified redirect URL. The redirect URL will have the following parameters appended:
?orderId=[ORDER_ID]&orderNumber=[ORDER_NUMBER]&status=[STATUS]
i.e https://your-redirect-url?orderId=004Qs494RxpEMFYUyXBz&orderNumber=323421&status=success
ORDER_ID
The TygaPay Order Id
ORDER_NUMBER
The orderNumber supplied in the creation of the order.
STATUS
Status of the order upon completion:
success: Payment has been successfully processed.
expired: The order has expired.
cancelled: The order has been cancelled.
Note: TygaPay will accommodate the specific format required for your redirect URL.
To process a refund to a cryptocurrency address, an OTP (One-Time Password) is necessary. Please reach out to support@tygapay.com to set up the Tenant Admin account that will receive these OTPs.
POST https://your-refund-notify-url
type*
string
order_refund | order_refund_crypto
orderId*
string
TygaPay Order Id.
orderNumber*
string
Unique Order Number .
status*
string
Status of the order refund upon completion:
refunded: Order has been refunded successfully.
date*
string
Order complettion date. i.e
2024-01-07T19:05:30.175Z
amount*
number
The refunded amount.
currency*
string
The refunded currency. i.e USDT
txId*
string
The payment TygaPay txId.
thirdPartyId
string
The specified thirdPartyId is used to initiate the refund request.
address
string
The address to which the refunded amount was sent. This address is provided when the type is order_refund_crypto.
token
string
The token, such as USDT, that has been transferred to the blockchain address.
network
string
The network used to transmit the token.
txHash
string
The blockchain transaction ID, which can be used to verify the legitimacy of the transfer.
/orders/:orderId/refund
Your unique API Key.
Your API Hash.
Name of the order.
Description of the order.
/orders/:orderId/refund/crypto/otp
The unique identifier of the order for which the refund is to be processed.
Your unique API Key.
Your API Hash.
/orders/:orderId/refund/crypto
The unique identifier of the order for which the refund is to be processed.
Your unique API Key.
Your API Hash.
Crypto address to which the refund will be sent.
Blockchain network used for the refund. e.g. 'BSC', 'MATIC', 'TRON'.
Type of cryptocurrency token to be refunded. e.g. 'USDT'.
An identifier for the third-party service, if applicable.
One-time password for transaction verification.
URL to notify upon the final status of the refund process.
/orders
Your unique API Key.
Your API Hash.
Order type e.g. "payment", "deposit".
Name of the order.
Description of the order.
Unique order number.
Total amount of the order. Amount is optional for 'deposit' orders.
Email of the customer making the order.
URL to notify after order is completed.
URL to redirect to after order is completed.
Optional customer information for the order.