Payments Overview | Gammal Tech Web SDK

⚠️ Payment Integration Requires Approval

Payment features require pre-approval from Gammal Tech. After approval, we manually configure your payment callback page. This is a security and compliance requirement — payment endpoints cannot be self-configured. Contact us at dev@gammal.tech to get started.

Payment Methods

Choose the right payment method for your audience:

👛

Wallet Payments

Accept payments from Gammal Tech Wallet. Perfect for Egyptian users and recurring customers.

✓ Currency: EGP (Egyptian Pound)

✓ Instant settlement

✓ Zero transaction fees for users

✓ Pre-funded wallet = no chargebacks

Learn More →

💳

Card Payments

Accept Visa, Mastercard, and other cards globally. Ideal for international customers.

✓ Currencies: USD, EUR, GBP, more

✓ Visa, Mastercard, AMEX

✓ 3D Secure authentication

✓ PCI-DSS compliant

Learn More →

Quick Comparison

Feature	Wallet (EGP)	Card (USD/EUR)
SDK Method	`GammalTech.pay()`	`GammalTech.payCard()`
Best For	Egyptian market	International market
User Experience	1-click if logged in	Card form in popup
Settlement	Instant	2-3 business days
Chargebacks	✓ Not possible	Possible (standard card rules)
Minimum Amount	1 EGP	$1 USD

Quick Start

Once approved, accepting payments is just one line of code:

Wallet Payment (EGP)

// Charge 100 EGP from user's wallet
GammalTech.pay(100, 'Premium Subscription', function(payment) {
    // Payment successful! Deliver the product
    console.log('Payment ID:', payment.id);
    deliverProduct(payment);
});

Card Payment (USD)

// Charge $29.99 USD via card
GammalTech.payCard(29.99, 'USD', 'Pro Plan - Monthly', function(payment) {
    // Payment successful! Deliver the product
    console.log('Payment ID:', payment.id);
    deliverProduct(payment);
});

Payment Flow

Both payment methods follow a secure delivery-confirmation pattern:

Payment → Verify → Deliver → Confirm

Step 1

User Pays

→

Step 2

SDK Verifies

→

Step 3

You Deliver

→

Step 4

Confirm Delivery

💡 Delivery Confirmation

After delivering the product/service, call GammalTech.payment.confirmDelivery() to mark the transaction complete. This protects both you and your customers.

Method Reference

Core Payment Methods

Method	Description
`GammalTech.pay(amount, description, onDeliver)`	Wallet payment in EGP. Calls onDeliver on success.
`GammalTech.payCard(amount, currency, description, onDeliver)`	Card payment in specified currency. Calls onDeliver on success.

Verification & Recovery Methods

Method	Description
`GammalTech.payment.verifyPayment(paymentId)`	Verify a payment's status with the server.
`GammalTech.payment.confirmDelivery(paymentId)`	Mark a payment as delivered/fulfilled.
`GammalTech.payment.settlePending()`	Recover and settle any pending payments from interrupted sessions.

Security Features

🔒 Bank-Grade Security

All payments are processed through Gammal Tech's secure infrastructure. Card details never touch your servers. PCI-DSS Level 1 compliant.

Built-in Protections

✓ Domain Verification — Payments only work from whitelisted domains

✓ Token Validation — Every payment verified against user's auth token

✓ Callback Protection — Only your approved callback page can receive payments

✓ Rate Limiting — Automatic protection against abuse

✓ Encryption — All data encrypted in transit and at rest

Getting Approved

To enable payments for your application:

→

Review

→

Configure

→

Go Live!

1. Contact Us: Email dev@gammal.tech with your app details.

2. Review: We review your application for compliance.

3. Configure: We set up your payment callback and limits.

4. Go Live: Start accepting payments!

Related Documentation

👛 Wallet Payments — Detailed guide for EGP wallet payments 💳 Card Payments — Detailed guide for international card payments 🔧 Payment Recovery — Handle interrupted payments

🤖

AI Prompt for Vibe Coding

Payments

Copy this prompt for help with payment integration:

I'm implementing payments with Gammal Tech Web SDK v3.0.1. Payment Methods: 1. Wallet (EGP): GammalTech.pay(amount, description, onDeliver) 2. Card (USD/EUR): GammalTech.payCard(amount, currency, description, onDeliver) Helper Methods: - GammalTech.payment.verifyPayment(paymentId) - Verify status - GammalTech.payment.confirmDelivery(paymentId) - Mark delivered - GammalTech.payment.settlePending() - Recover interrupted payments Flow: User pays → SDK verifies → onDeliver called → You deliver → confirmDelivery() Key Points: - Requires pre-approval from Gammal Tech - Only ONE page can handle payment callbacks (configured by Gammal Tech) - User must be logged in before paying - Always call confirmDelivery() after delivering product Please help me: [DESCRIBE YOUR PAYMENT TASK]