Initiate Account Payment

This payment option is called to make account payments.
Authentication
Request Body
Response Body
Authentication
curl -X POST
https://seerbitapi.com/api/v2/payments/initiates
-H 'Content-Type: application/json'
-H 'Authorization: Bearer {token}
Request Body
{
"publicKey":"merchantPublicKey",
"amount":"2000.00",
"fee":"10",
"fullName":"John Doe",
"mobileNumber":"08037456590",
"currency":"NGN",
"country":"NG",
"paymentReference":"UYTRE234566677RDFGFDDSS",
"email":"johndoe@gmail.com",
"productId":"Foods",
"productDescription":"Uba Account Transaction ",
"clientAppCode":"kpp64",
"channelType":"BANK_ACCOUNT",
"redirectUrl":"https://checkout.seerbit.com",
"paymentType":"ACCOUNT",
"deviceType":"Apple Laptop",
"sourceIP":"127.0.0.1:3456",
"accountName":"John S Doe",
"accountNumber":"1234567890",
"bankCode":"033",
"bvn":"12345678901",
"dateOfBirth":"04011984",
"retry":"false",
"invoiceNumber":"1234567891abc123ac"
}
Response Body
{
"status": "SUCCESS",
"data": {
"code": "S20",
"payments": {
"paymentReference": "UYTRE234566677RDFGFDDSS",
"linkingReference": "F320660611587911267617"
},
"message": "Transaction is pending"
}
}

Field

Description

Type

publicKey

This is available after sign-up

dash board -> settings -> api keys.

String

Required

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

fullName

Customer name

String

Optional

mobileNumber

Customer phone number

String

Optional

currency

Currency to perform transaction

String

Required

country

Country the customer is performing the transaction

String

Required

paymentReference

Unique payment identifier, to be supplied by the merchant

String

Required

email

Customer's Email

String

Required

productId

Unique identification number for each product, To be supplied by the Merchant

String

Optional

productDescription

Narration of Transaction

String

Optional

clientAppCode

Extra data

String

Optional

channelType

Type of card { mastercard, verve, visa }

String

Required

redirectUrl

Url to redirect to

String

Required

bvn

Customers' bank verification number.

String

Optional

paymentType

Medium by which the payment transaction is made {ACCOUNT}

String

Required

deviceType

Customer device

String

Optional

sourceIP

Customer's IP Address

String

Optional

accountName

Customer's account name

String

Required

accountNumber

Customer's account number to debit

String

Required

bankCode

Bank's Unique identifier

String

Required

dateOfBirth

Customer's registered date of birth for debit card

String

Optional

retry

This is passed as true to retry a failed transaction.

Boolean

Required

invoiceNumber

String

Optional

message

Response message from SeerBit

code

Response code from SeerBit

linkingReference

SeerBit transaction unique identifier