API
  • Introduction
  • Authentication
  • Error Handling
  • API ENDPOINTS
    • Payment
    • Invoices
      • Create Invoice
      • Re-send Invoice
      • Get Invoice - customerEmail
      • Get Invoice - invoiceNo
      • Get Invoice - orderNo
    • Payment Link
      • Create Link
      • Get Link
      • Update Link
      • Delete Link
    • Charge Token
      • Create Token
      • Get Token
      • Charge Token
      • Bulk Charge
      • Query Bulk Charge with BacthId
    • Subscriptions
      • Create Subscription
      • Charge Subscription
      • Get Customer Subscription
      • Update Customer Subscription
      • Get Merchant Subscription
    • Virtual Account
      • Create Virtual Account
      • Get Virtual Account
      • Delete Virtual Account
      • Get Payment
    • Pay with Transfer
    • Pay with USSD
    • Mobile Money Payments
    • Bank Account Payments
    • Card Payment
      • Initializing a Card Payment
      • Scenario 1 (Verve Card Type)
      • Scenario 2 (Master Card and Visa Card Type)
      • Scenario 3
Powered by GitBook
On this page
  1. API ENDPOINTS

Pay with USSD

/payments/initiates

POST https://seerbitapi.com/api/v2/payments/initiates

Headers

Name
Type
Description

authorization*

String

Bearer Token

content-type*

String

application/json

Request Body

Name
Type
Description

publicKey*

String

This is the merchant public key.

amount*

String

This is the amount to be paid.

email*

String

This is the email of the customer.

country*

String

This is the country from which the transaction is been carried out from

paymentReference*

String

This is the unique identifier for a transaction, to be generated by merchant.

mobileNumber*

String

fullName*

String

currency*

String

callbackUrl*

String

redirectUrl*

String

paymentType*

String

bankCode*

String

{
  "status": "SUCCESS",
  "data": {
    "code": null,
    "payments": {
        "paymentReference": "dsffererer",
        "linkingReference": "CSEERBIT724622561618580872054",
        "providerreference": "8206",
        "ussdDailCode": "*901*000*8206#"
    },
    "message": null
  }
}
curl --location 'https://seerbitapi.com/api/v2/payments/initiates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ENCRYPTION_KEY' \
--data-raw '{
    "publicKey":"YOUR_PUBLIC_KEY",
    "amount":"100",
    "fullName": "FirstName LastName",
    "mobileNumber": "customer mobile number",
    "email":"firstname@mail.com",
    "currency": "NGN",
    "country": "NG",
    "paymentReference": "dsffererer",
    "callbackUrl": "http://yourdomain.com",
    "redirectUrl": "http://yourdomain.com",
    "paymentType": "USSD",
    "bankCode":"044"
  }'
PreviousPay with TransferNextMobile Money Payments

Last updated 8 months ago