Payment Providers
Complete reference for supported payment providers and their configurations
Payment Providers Reference
All payment providers supported by the Rahal booking system.
Provider Values
| Provider | Description |
|---|---|
| Super Qi App | Mobile wallet (Iraq) |
| Checkout.com | Card payments |
| Buy Now Pay Later | Installment payments |
| Sandbox | Testing only |
| Corporate Direct | Company billing |
| QI Services App | Legacy mobile wallet |
Provider Details
SUPER_QI_APP
Primary consumer payment method for the Iraqi market.
| Property | Value |
|---|---|
| Code | SUPER_QI_APP |
| Type | Mobile wallet |
| Region | Iraq |
| Verification | API callback |
| Fees | None to user |
Payment Flow:
- Redirect to Super Qi app
- User approves in wallet
- Webhook confirms payment
- Order processing continues
CHECKOUT_COM
International card payment processing.
| Property | Value |
|---|---|
| Code | CHECKOUT_COM |
| Type | Card payment |
| Networks | Visa, Mastercard, etc. |
| Security | 3D Secure |
| Verification | Webhook |
Payment Flow:
- Hosted payment form
- Card details entered
- 3DS if required
- Webhook confirms payment
BNPL
Buy Now, Pay Later installment payments.
| Property | Value |
|---|---|
| Code | BNPL |
| Type | Installments |
| Fee | Percentage of amount |
| Verification | Provider callback |
Payment Flow:
- Eligibility check
- Installment plan selection
- First payment processed
- Remaining installments scheduled
BNPL orders include fee amount and percentage fields. Transactions show as unpaid until all installments are confirmed.
SANDBOX
Test payment provider for development.
| Property | Value |
|---|---|
| Code | SANDBOX |
| Type | Test/mock |
| Verification | Always success |
| Availability | Dev/staging only |
Payment Flow:
- Order created
- Payment automatically verified
- Processing continues normally
SANDBOX should never be available in production. It bypasses all payment verification.
CORPORATE_DIRECT
Company billing for corporate travel.
| Property | Value |
|---|---|
| Code | CORPORATE_DIRECT |
| Type | Company billing |
| Payment | None (invoiced) |
| Policy | Integrated |
| Budget | Integrated |
Payment Flow:
- Policy evaluation
- Budget evaluation
- Order created (no payment)
- Budget reserved
- Reservations created
- Budget confirmed
QI_SERVICES_APP
Legacy mobile wallet provider.
| Property | Value |
|---|---|
| Code | QI_SERVICES_APP |
| Type | Mobile wallet (legacy) |
| Status | Deprecated |
Note: This provider is retained for historical orders. New bookings should use SUPER_QI_APP.
Provider Comparison
| Feature | SUPER_QI | CHECKOUT | BNPL | SANDBOX | CORP_DIRECT |
|---|---|---|---|---|---|
| Real payment | Yes | Yes | Yes | No | No |
| Instant | Yes | Yes | First only | Yes | Yes |
| Fees to user | No | No | Yes | No | No |
| Card required | No | Yes | No | No | No |
| Policy check | No | No | No | No | Yes |
| Budget track | No | No | No | No | Yes |
Provider Selection
Providers are available based on context:
| Context | Available Providers |
|---|---|
| Consumer App (Iraq) | SUPER_QI_APP, BNPL |
| Consumer Web | SUPER_QI_APP, CHECKOUT_COM |
| Corporate App | CORPORATE_DIRECT |
| Development | SANDBOX, all others |
Filtering by Provider
In the dashboard:
- Go to Orders
- Select provider from dropdown filter
- List shows only orders for that provider
Provider-Specific Fields
Standard Fields (all providers)
| Field | Description |
|---|---|
provider | Provider code |
paymentId | External payment reference |
paymentAmount | Total amount |
BNPL-Specific Fields
| Field | Description |
|---|---|
bnplFeeAmount | Fee amount in sub-units |
bnplFeePercentage | Fee percentage |
Corporate-Specific Fields
| Field | Description |
|---|---|
companyId | Company reference |
policyId | Applied policy reference |
Error Handling by Provider
| Provider | Common Errors | Resolution |
|---|---|---|
| SUPER_QI_APP | Insufficient balance | User adds funds |
| CHECKOUT_COM | Card declined, 3DS failed | User retries |
| BNPL | Not eligible | Use different payment |
| CORPORATE_DIRECT | Policy/budget block | Request approval or modify booking |