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
Authentication
curl -X POST
https://seerbitapi.com/api/v2/payments/order
-H 'Content-Type: application/json' 
-H 'Authorization: Bearer {token}
Request
{
    "email":"[email protected]",
		"publicKey":"merchant public key",
		"paymentReference": "3SG109R81342E292312R569Q2I59",
		"fullName":"John Doe",
		"orderType":"BULK_BULK",
		"mobileNumber":"08000000001",
		"callbackUrl":"https://yourdomain.com",
		"country":"NG",
		"currency":"NGN",
		"amount":"1400",
		"orders":[
							   				{
														"orderId":"22S789420214623",
														"currency":"NGN",
														"amount":"500.00",
														"productId":"fruits",
														"productDescription":"mango"
												},
												{
														"orderId":"1a3sa82748272556947",
														"currency":"NGN",
														"amount":"900.00",
														"productId":"fruits",
														"productDescription":"orange"
												}
							]
}
Response
{
    "status": "SUCCESS",
    "data": {
        "code": "00",
        "payments": {
            "amount": "1400.00",
            "paymentReference": "3SG109R81342E292312R569Q2I59",
            "paymentStatus": "08",
            "redirectLink": "https://yourdomain.com?mid={merchant public key}&paymentReference=3SG109R81342E292312R569Q2I59"
        },
        "message": "Successful"
    }
}
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 updated 1 year ago

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