Order

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":"johndoe@gmail.com",
"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"
}
}

Field

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