API Reference · Cards
Card Authorizations
Proposed card authorization holds and synchronous JIT decisions. Not built.
The card_authorization object
Represents a card_authorization entity in the rafiqPay system.
| Field | Type & Flags | Description |
|---|---|---|
| id | string | Authorization ID (cau_...). |
| mcc | string | 4-digit Merchant Category Code. |
| status | enum | pending | approved | declined. |
Example card_authorization JSON
card_authorization example payload
{
"id": "cau_01",
"cardId": "crd_01",
"amount": "18500.00",
"mcc": "5812",
"status": "approved"
}Endpoints & Operations
GET/v1/card-authorizations/:idProposed
Retrieve an authorisation
Retrieves a card authorization.
Request Example
GET /v1/card-authorizations/:id
cURL · v1
curl -X GET "https://api.rafiqpay.net/v1/card-authorizations/:id" \
-H "Authorization: Bearer rp_test_sk_kanzu_9f8a7b6c5d4e3f2a"Response (200 OK)
Response payload
{
"id": "cau_01",
"status": "approved"
}GET/v1/card-authorizationsProposed
List authorisations
Lists card authorizations.
Request Example
GET /v1/card-authorizations
cURL · v1
curl -X GET "https://api.rafiqpay.net/v1/card-authorizations" \
-H "Authorization: Bearer rp_test_sk_kanzu_9f8a7b6c5d4e3f2a"Response (200 OK)
Response payload
{
"object": "list",
"data": [],
"hasMore": false,
"nextCursor": null
}POST/v1/card-authorizations/:id/approveProposed
Approve a pending authorisation
Approves a pending authorization.
Request Example
POST /v1/card-authorizations/:id/approve
cURL · v1
curl -X POST "https://api.rafiqpay.net/v1/card-authorizations/:id/approve" \
-H "Authorization: Bearer rp_test_sk_kanzu_9f8a7b6c5d4e3f2a" \
-H "Idempotency-Key: idem_approve-card-auth_01"Response (200 OK)
Response payload
{
"id": "cau_01",
"status": "approved"
}POST/v1/card-authorizations/:id/declineProposed
Decline a pending authorisation
Declines a pending authorization.
Request Example
POST /v1/card-authorizations/:id/decline
cURL · v1
curl -X POST "https://api.rafiqpay.net/v1/card-authorizations/:id/decline" \
-H "Authorization: Bearer rp_test_sk_kanzu_9f8a7b6c5d4e3f2a" \
-H "Idempotency-Key: idem_decline-card-auth_01"Response (200 OK)
Response payload
{
"id": "cau_01",
"status": "declined"
}Related Webhook Events
These events are dispatched to your webhook endpoints when actions occur on this resource: