Create order before payment

Search…
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
​
​
Payment Features
Create Order after Payment
Last modified 1yr ago
Copy link