Create Order
Create an order in EzeebitPay and redirect to the payment interface (payment_url).
Live:
POST https://api.ezeebit.com/open/api/v1/newOrder
UAT:
POST https://dev-api.ezeebit.com/open/api/v1/newOrder
Headers
Content-Type
string
Y
application/json
Ezeebit-Timestamp
long
Y
UnixTimestamp in milliseconds
Ezeebit-Nonce
string
Y
must be 32 digits
Ezeebit-Certificate-SN
string
Y
API key issued by Ezeebit Pay system
Ezeebit-Signature
string
Y
this should use SHA512, and be in upper case
Request Body
{
"amount": 2.00,
"tradeOrderNo": "100001",
"storeNumber": "6715176569",
"webHookUrl": "https://310b-103-196-26-24.ngrok-free.app/testWebhook"
}Form data
amount
double
Y
The amount of the order
tradeOrderNo
string
Y
The order number of the calling system. Note: This can be randomly generated. Having a timestamp in front of the random number generated might keep the order number more accurate
storeNumber
string
Y
The Store Number of the Merchant, It can be obtained from the Store List of Merchant Portal or through the Get Merchant interface
webHookUrl
string
N
Send an automated message to Merchant WebHook URL when order status is changed
Response
200
Order created successfully
Example Response
{
"code": 200,
"msg": "success",
"data": {
"payId": "8902553d6ad8477f812a0432f2243c0f",
"paymentLink": "https://dev-payment.ezeebit.com/pay/8902553d6ad8477f812a0432f2243c0f",
"currency": "ZAR",
"amount": "40.00"
}
}{
"code": 400,
"msg": "orderAmount must be greater than 0",
"data": null
}{
"code": 10008,
"msg": "Store number not found",
"data": null
}{
"code": 10010,
"msg": "The transaction order number is duplicate",
"data": null
}{
"code": 10001,
"msg": "Incorrect signature result",
"data": null
}{
"code": 10003,
"msg": "API identity key not found or invalid.",
"data": null
}Last updated