Create order before payment
Order objects are created to handle purchases of previously defined products. You can create and pay for bulk orders
Authentication
Request
Response
1
curl -X POST
2
https://seerbitapi.com/api/v2/payments/order
3
-H 'Content-Type: application/json'
4
-H 'Authorization: Bearer {token}
Copied!
1
{
2
"email":"[email protected]",
3
"publicKey":"merchant public key",
4
"paymentReference": "3SG109R81342E292312R569Q2I59",
5
"fullName":"John Doe",
6
"orderType":"BULK_BULK",
7
"mobileNumber":"08000000001",
8
"callbackUrl":"https://yourdomain.com",
9
"country":"NG",
10
"currency":"NGN",
11
"amount":"1400",
12
"orders":[
13
{
14
"orderId":"22S789420214623",
15
"currency":"NGN",
16
"amount":"500.00",
17
"productId":"fruits",
18
"productDescription":"mango"
19
},
20
{
21
"orderId":"1a3sa82748272556947",
22
"currency":"NGN",
23
"amount":"900.00",
24
"productId":"fruits",
25
"productDescription":"orange"
26
}
27
]
28
}
Copied!
1
{
2
"status": "SUCCESS",
3
"data": {
4
"code": "00",
5
"payments": {
6
"amount": "1400.00",
7
"paymentReference": "3SG109R81342E292312R569Q2I59",
8
"paymentStatus": "08",
9
"redirectLink": "https://yourdomain.com?mid={merchant public key}&paymentReference=3SG109R81342E292312R569Q2I59"
10
},
11
"message": "Successful"
12
}
13
}
Copied!
Parameter
Description
Type
publicKey
This is available after sign-up
dash board -> settings -> api keys.
String
Required
fullName
customer name
String
Optional
amount
amount to be paid
String
Required
fee
charge on transaction, customer or merchant to bear
whom to bear this can be set on the dashboard by merchant
String
Optional
mobileNumber
customer phone number
String
Optional
currency
Currency to perform transaction
String
Required
country
Country the customer is performing transaction
String
Required
paymentReference
Unique payment reference/identifier, To be supplied by the Merchant
String
Required
email
Customer email address
String
Required
productId
Unique identification number of product, To be supplied by Merchant
String
Optional
productDescription
Narration of the transaction
String
Optional
orderId
Unique identifier for specific order
String
Required
orderType
{BULK_BULK}
String
Required
code
Response code from SeerBit
linkingReference
SeerBit transaction unique identifier
Last modified 1yr ago
Copy link