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
  2. Card Payment

Scenario 1 (Verve Card Type)

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

Scenario 1 (Verve Card Type)

  1. The customers gets prompted to enter card pin.

  2. After the customer enters the card pin, call the payment service again using payment/initiates endpoint.

  3. An OTP (one time password) is sent to the cardholders registered phone number or email to validate the transaction.

  4. To Validate the transaction Call the Validate OTP payments/otp endpoint with the customers OTP and Pass the transactions linking reference in the request body.

curl --location 'https://seerbitapi.com/api/v2/payments/initiates' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ENCRYPTION_KEY' \
--data '{
	"transaction":
		{
		 "linkingreference":"F468778061587905955047",
         "otp":"496865"
         }
}'
{
	"status": "SUCCESS",
	"data": {
		"code": "00",
		"payments": {
			"reference": "LKJHGFDR123UI23992JN23R",
			"linkingreference": "F468778061587905955047"
		},
		"message": "Successful"
	}
}
PreviousInitializing a Card PaymentNextScenario 2 (Master Card and Visa Card Type)

Last updated 9 months ago