Custom Integration

Copy page

Copy page as Markdown for LLMs

Open in ChatGPT

Ask questions about this page

Open in Claude

Ask questions about this page

Custom Integration provides advanced payment processing capabilities that allow you to build a fully customized checkout experience directly on your website. This integration method gives you complete control over the payment form design, user experience, and transaction flow while maintaining security and compliance standards.

Integration Types

Custom integration supports two implementation approaches based on your PCI compliance status:

Non-PCI Certified

The Non-PCI Certified approach allows you to build custom payment experiences while Amazon Payment Services handles PCI compliance requirements:

• Secure tokenization - Card details are tokenized before processing
• Reduced compliance overhead - Amazon Payment Services manages PCI requirements
• Custom UI/UX - Full control over payment form design and user experience
• Enhanced security - Sensitive card data never touches your servers

PCI-Certified

The PCI-Certified approach provides direct server-to-server communication for enterprises with existing PCI compliance:

• Direct API processing - Handle card data directly through secure server communication
• Advanced capabilities - Access to full range of payment processing features
• Complete control - Full transaction data control and customization

PCI-Certified integration requires active PCI DSS Level 1 compliance, including:

• Valid PCI DSS certification maintenance
• Secure card data handling and encryption procedures
• Regular security assessments and compliance audits
• Secure network architecture and access controls
• Ongoing compliance monitoring and reporting

How Custom Integration Works

Non-PCI Certified Flow

The Non-PCI Certified payment process follows these steps:

1

Payment Form Creation and Data Collection

Build custom payment form on your checkout page and collect customer payment details in your custom form.

2

Secure Tokenization

Merchant website submits card data directly to Amazon Payment Services, and APS returns secure token to merchant's return URL.

3

Payment Processing

Merchant processes payment using the token returned in tokenization step from their server-side. APS returns 3DS URL if authentication required.

4

Transaction Completion

Merchant redirects customer to 3DS authentication, and APS sends final response back to merchant after 3DS completion.

PCI-Certified Flow

The PCI-Certified payment process follows these steps:

1

Secure Form and Data Collection

Implement PCI DSS Level 1 compliant payment form and collect customer payment details in your secure form.

2

Direct Processing

Handle card data directly through secure server-to-server communication and process payment with full control over card data and processing.

3

3D Secure and Transaction Completion

Handle 3D Secure authentication with enhanced security controls and complete transactions with full audit trail and compliance.

Supported Payment Methods

Cards

Card Type	Supported Regions	Notes
Visa	Global	All card types supported
Mastercard	Global	All card types supported
American Express	Global	All card types supported
MADA	Saudi Arabia	Local debit card scheme
Meeza	Egypt	Local debit card scheme

Digital Wallets

Wallet	Supported Regions	Integration Notes
Apple Pay	60+ countries	Available for iOS and web implementations

Local Payment Methods

Payment Method	Country	Currency	Notes
STC Pay	Saudi Arabia	SAR	Requires phone number validation
valU	Egypt	EGP	Consumer finance with installment plans

Key Features

• Complete UI control - Build fully customized payment forms and checkout flows
• Advanced payment options - Support for cards, wallets, and local payment methods
• Save Card feature - Allows customers to securely store their card details for future transactions.
• Card tokenization - Secure card storage for repeat customers with "Remember Me" functionality
• Installment payments - Built-in installment options where available
• PCI DSS compliant - Choose between PCI-certified and non-PCI certified approaches
• 3D Secure authentication - Built-in fraud protection with custom handling
• Recurring payments - Support for subscription and recurring billing
• Direct API control - Full control over payment processing and business logic
• Multi-language support - Arabic and English interfaces
• Mobile responsive - Build optimized experiences for all device types
• Custom success flows - Design your own transaction confirmation pages
• Advanced reporting - Access detailed transaction data and analytics

Who Should Use Custom Integration?

Custom Integration is ideal for:

Non-PCI Certified Merchants

• Enterprise merchants who need complete control over checkout experience design
• Custom payment flows that align with specific business logic
• Professional payment interface without PCI compliance overhead
• Integration flexibility while maintaining security standards
• Fast development with reduced compliance requirements

PCI-Certified Merchants

• Large enterprises who require direct processing of sensitive card data
• Advanced payment processing capabilities and custom business logic
• Full transaction data control and customization
• Existing secure infrastructure for card data handling
• Complex payment workflows requiring direct API access

Check our interactive prototypes to visualize the implementation