Initiate Card Transaction

This Operation allows merchant to initiate a transaction request with the parameters below through an Api call.
Athentication
Request Body
Response Body
Athentication
curl -X POST
https://seerbitapi.com/api/v2/payments/initiates
-H 'Content-Type: application/json'
-H 'Authorization: Bearer {token}
Request Body
{
"publicKey":"merchantPublicKey",
"amount":"100.00",
"fee":"10",
"fullName":"John Doe",
"mobileNumber":"08032000001",
"currency":"NGN",
"country":"NG",
"paymentReference":"LKJHGFDR123UI23992JN23R",
"email":"johndoe@gmail.com",
"productId":"Foods",
"productDescription":"RASPBERRY",
"clientAppCode":"kpp64",
"redirectUrl":"https://google.com",
"paymentType":"CARD",
"scheduleId":"",
"channelType":"Mastercard",
"deviceType":"Apple Laptop",
"sourceIP":"127.0.0.1:3456",
"cardNumber":"5123450000000008",
"cvv":"100",
"expiryMonth":"05",
"expiryYear":"21",
"pin":"####",
"retry":"false",
"invoiceNumber":"1234567890abc123ac"
}
Response Body
{
"status": "SUCCESS",
"data": {
"code": "S20",
"payments": {
"paymentReference": "LKJHGFDR123UI23992JN23R",
"linkingReference": "F468778061587905955047",
"redirectUrl": "https://staging.seerbitapigateway.com/seerbit/card-dispatch?sredref=F468778061587905955047"
},
"message": "Transaction is pending"
}
}

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

clientAppCode

Extra Data

String

Optional

redirectUrl

url to redirect to

String

Required

paymentType

This specifies the payment option used {CARD, ACCOUNT, TRANSFER}

String

Required

scheduleId

Unique identifier for bulk payment

optional

channelType

Type of card {master card, verve, visa}

String

Required

deviceType

Costumer's device

String

Optional

sourceIP

Customer IP Address

String

Optional

cardNumber

Customer's card number

String

Required

cvv

Three digit behind customer's card

String

Required

expiryMonth

Card expiration month

String

Required

expiryYear

Card expiration year

String

Required

pin

Card pin to authorise debit

String

Required

retry

This should be passed as true for retrying a transaction with same reference

Boolean

Required

invoiceNumber

Unique identifier for invoice Transactions to the locate branch payment was made

String

Optional

message

Response message from SeerBit

code

Response code from SeerBit

linkingReference

SeerBit transaction unique identifier

When a request is made to initiate card transaction service, the response from SeerBit determines the next line of action. For a successful initial call, code S20 will be returned. If the response has a redirect link in the redirectUrl field, merchant is expected to redirect to the link. Because of this merchant is expected to always pass the redirectUrl link that SeerBit should come back to after going to complete payment on 3DS site. However, if the redirectUrl field is null, a message "Kindly enter OTP" will be received. To complete this payment with OTP, click here. Sometimes before OTP is requested you may get this message "Kindly enter your PIN" with code S20. Click here for possible response codes on SeerBit.