The Payment Provider integration in Subotiz requires specific API credentials for each provider to establish a secure connection and enable transaction processing. Credential requirements vary based on the provider’s platform structure, authentication model, and supported payment methods. This guide outlines the required credentials, available payment options, and 3D Secure payment setup support for each integration.
Note:
- Configuration location: All providers can be configured in Settings > Payment Provider in the Subotiz admin.
- Setup guidance: Steps for adding and managing providers are outlined in Payment providers｜Viewing and Managing Payment Providers.
Airwallex
Required fields Airwallex requires API-based credentials to authenticate the connection and support real-time transaction updates.
- Display name: Internal label displayed within the Subotiz admin.
- Client ID: Available in the Airwallex developer portal.
- API Key: Used to authenticate API communication.
- Webhook Secret: Enables Subotiz to receive payment event updates.
Supported payment methods
- Visa
- Mastercard
- American Express
- JCB
- UnionPay
- Discover
- Diners Club
- Apple Pay
- Google Pay
Official link: Airwallex Developer Portal – Manage API Keys
Ocean Payment
Required fields Ocean Payment separates credentials by transaction type. One-time payment credentials are mandatory. Fields for subscriptions or recurring billing can be added if those features are required. All credentials (Account, Terminal, SecureCode) are typically provided by Ocean Payment during account setup via email or accessible within your Ocean Payment merchant portal dashboard.
One-time payments
- Display name
- Account
- Terminal
- SecureCode
Subscriptions
Used for the initial subscription payment (the first charge when a customer activates a subscription):
- Account
- Terminal
- SecureCode
Recurring billing
Used for subsequent subscription payments (automatic renewals from the second billing cycle onward):
- Account
- Terminal
- SecureCode
Supported payment methods
- Visa
- Mastercard
- American Express
- JCB
- UnionPay
- Discover
- Diners Club
Official link: Ocean Payment: Official Site
PayPal
Required fields PayPal uses OAuth for account connection. No manual credential input is required. To connect, select Connect in the Subotiz admin and complete the PayPal authorization flow. Once connected, payment methods can be enabled in the settings.
Version options
-
Advanced (Business account)
- PayPal Wallet
-
ACDC (Advanced Credit and Debit Card)
-
Supported card brands:
- Mainland China merchants: Visa, Mastercard
- Other regions: Visa, Mastercard, American Express, JCB, Unionpay, Discover, Diners Club
- Supports subscription and recurring billing
-
-
BCDC (Basic Credit and Debit Card)
- Supported card brands: Visa, Mastercard, American Express, Discover
- Limitation: BCDC does not support subscription payments
- Apple Pay
-
Google Pay
- Limitation: Google Pay does not support subscription payments
- Subscription
-
Basic (Business & Personal account)
-
PayPal Wallet
- Limitation: Subscription not supported
-
BCDC (Basic Credit and Debit Card)
- Supported card brands: Visa, Mastercard, American Express, Discover
- Limitation: Subscription not supported
-
Supported payment methods
- PayPal wallet
- Credit and debit cards (via PayPal Vault, ACDC, or BCDC)
- Apple Pay (Advanced version only)
- Google Pay (Advanced version only)
3D Secure support
- By default, 3DS verification is applied to card transactions only when required by regulations.
- If 3DS is enabled, every Advanced credit and debit card transaction will go through 3DS verification.
- While 3DS helps reduce fraud, it may lower the payment success rate.
Regional availability Advanced credit and debit card, Apple Pay, Google Pay, and subscription services are supported only in selected regions for Business accounts. You can rebind your PayPal account to check availability.
Official link: How does PayPal handle 3-D Secure (3DS) authentication for Branded Checkout Transactions?
PayerMax
Required fields PayerMax requires MerchantNo and Auth Token to authenticate the connection.
- Display name: Internal label displayed within the Subotiz admin.
- MerchantNo: Available in the PayerMax merchant portal.
- Auth Token: Generated in the merchant account settings.
Supported payment methods
- Visa
- Mastercard
Official link: PayerMax: Integration Guide
Checkout.com
Required fields Checkout.com uses key-based authentication for API communication.
- Display name: Internal label displayed within the Subotiz admin.
- Public Key: Available in the Checkout.com dashboard.
- Secret Key: Used to authenticate secure API requests.
Supported payment methods
- Visa
- Mastercard
- American Express
- JCB
- Discover
3D Secure support 3D Secure (3DS) is supported for credit card transactions and can be enabled in the provider settings.
Official link: Checkout.com: Access API Keys
Maintaining stable integrations requires setting up and managing credentials correctly. Always refer to each provider’s documentation for the latest requirements, and review your configuration regularly to ensure secure and uninterrupted payment processing.