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 2 (Master Card and Visa Card Type)

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

Scenario 2 (Master Card and Visa Card Type)

  1. The occurs for 3D secure card transactions.

  2. After the payment has been initiated, the card holder gets prompted to complete the payment on the card's bank page.

  3. For a successful initial call, code S20 will be returned with 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 the payment is completed on 3Ds site.

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": "S20",
			"payments": {
					"paymentReference": "LKJHGFDR123UI23992JN23R",
					"linkingReference": "F468778061587905955047",
					"redirectUrl": "https://seerbitapigateway.com/seerbit/card-dispatch sredref=F468778061587905955047"
			},
			"message": "Transaction is pending"
	}
}
PreviousScenario 1 (Verve Card Type)NextScenario 3

Last updated 9 months ago