💳 Payment Server Examples

ℹ️ Info: This page demonstrates how to use the credit card payment iframe with tokenization.
🔐 Tokenization Mode: All payments use tokenization (AK mode) by default to securely save card details.
🔐 One-Time Token Authentication

Secure your API requests with username/password authentication that generates one-time access tokens.

🔑 Generate Token 🧪 Test Authentication

📝 Example 1: Basic Credit Card Payment (Tokenization)

Minimal configuration with auto-generated URLs:

/payment/creditcard/iframe?id=CC-BASIC123&sum=50
Try Credit Card Payment (₪50)

📝 Example 2: Credit Card with Custom Notify URL

Specify a custom webhook URL for notifications:

/payment/creditcard/iframe?id=CC-CUSTOM456&sum=100¬ifyUrl=https://auhmewar3m.eu-central-1.awsapprunner.com/api/payments/webhook/test-123
Try Custom Notify URL (₪100)

📝 Example 3: Full Custom URLs

Specify custom success, failure, and notify URLs:

/payment/creditcard/iframe?
  id=CC-FULL789&
  sum=250&
  successUrl=http://localhost:3000/payment/creditcard/success&
  failureUrl=http://localhost:3000/payment/creditcard/failure&
  notifyUrl=http://localhost:3000/payment/creditcard/notify
Try Full Custom URLs (₪250)

📝 Example 4: JavaScript Dynamic Link Generation

Generate payment links programmatically:

📚 API Endpoints

Credit Card Payment (Tokenization):
  • Payment Iframe: GET /payment/creditcard/iframe
  • Success Handler: GET/POST /payment/creditcard/success
  • Failure Handler: GET/POST /payment/creditcard/failure
  • Webhook/Notify: POST /payment/creditcard/notify
Coming Soon:
  • Apple Pay: /payment/applepay/*
  • Bit Payment: /payment/bit/*
Other:
  • Health Check: GET /health

⚙️ Query Parameters

Parameter Description Default
paymentSessionId Payment session ID for backend tracking -
id Payment identifier (fallback for session ID) Auto-generated
sum Payment amount 1
currency Currency code (1=ILS, 2=USD) 1 (ILS)
appSuccessUrl App URL to redirect on success -
appFailureUrl App URL to redirect on failure -
notifyUrl Webhook notification URL /payment/notify
successUrl Success redirect URL /payment/success
failureUrl Failure redirect URL /payment/failure
tranmode Transaction mode (AK=Tokenization, NK=Normal) AK (Tokenization)
supplierName Tranzila supplier name raanan
⚠️ Important: Make sure to configure your .env file with your actual API base URL and API key before using in production!

🧪 Test Complete Payment Flow

Try the full payment flow with sample app return URLs:

🚀 Test Payment with Session ID

This test uses paymentSessionId=test-session-123 and will call your backend APIs.
After payment, you'll be redirected to sample app pages.
Sample app pages: /app/dashboard | /app/payment-success | /app/payment-failure