curl --request POST \
--url https://brain.orcuspay.com/api/v1/checkout/sessions/pay_prod_abc123/verify \
--header 'content-type: application/json' \
--data '{
"transaction_id": "BKA12345XYZ",
"payment_method_id": "pm_bkash_123",
"business_payment_method_id": "bpm_bkash_123"
}'
{
"data": {
"status": "SUCCEEDED"
}
}
Native Checkout
Verify Transaction
Submit a bKash/Nagad transaction ID for manual verification.
POST
/
api
/
v1
/
checkout
/
sessions
/
{id}
/
verify
curl --request POST \
--url https://brain.orcuspay.com/api/v1/checkout/sessions/pay_prod_abc123/verify \
--header 'content-type: application/json' \
--data '{
"transaction_id": "BKA12345XYZ",
"payment_method_id": "pm_bkash_123",
"business_payment_method_id": "bpm_bkash_123"
}'
{
"data": {
"status": "SUCCEEDED"
}
}
Submits a transaction ID (from bKash, Nagad, Rocket, etc.) for verification.
On success, the payment status transitions to
SUCCEEDED and the
checkout.session.complete webhook fires.
No API key required — access is scoped by session ID.
Path Parameters
string
required
The checkout session / payment ID.
Body
string
required
The transaction ID from the payment provider (e.g. bKash transaction ID).
string
required
The payment method ID (from the
payment_method_id field in the payment
methods array returned by
Get Checkout Data).string
required
The business payment method ID (from the
id field in the payment methods
array returned by
Get Checkout Data).Response
Error codes
| Code | Meaning |
|---|---|
invalid_transaction | The transaction ID is invalid, already used, or does not match the expected amount |
invalid_status | The payment is not in PENDING status |
not_found | The payment or payment method was not found |
curl --request POST \
--url https://brain.orcuspay.com/api/v1/checkout/sessions/pay_prod_abc123/verify \
--header 'content-type: application/json' \
--data '{
"transaction_id": "BKA12345XYZ",
"payment_method_id": "pm_bkash_123",
"business_payment_method_id": "bpm_bkash_123"
}'
{
"data": {
"status": "SUCCEEDED"
}
}