israeli-payment-orchestrator

Orchestrate Israeli payment gateways with unified routing, fallback, and installment handling.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/amitpo23/cfo --skill israeli-payment-orchestrator-amitpo23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: israeli-payment-orchestrator
Source: https://github.com/amitpo23/cfo/tree/main/.claude/skills/israeli-payment-orchestrator
Command: npx skills add https://github.com/amitpo23/cfo --skill israeli-payment-orchestrator-amitpo23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Israeli merchants integrating multiple payment gateways face inconsistent API formats, complex installment (tashlumim) rules on the Shva network, and regulatory requirements from the Bank of Israel and ISA. This Skill provides a unified abstraction layer for routing, fallback, and compliance across Cardcom, Tranzila, PayMe, Meshulam, iCredit, and Pelecard. ## Core Features & Use Cases - Gateway Comparison & Selection: Compare six Israeli gateways by API style, installment support, Bit/Apple Pay, fees, and settlement timing using the bundled comparison script and reference matrix. - Unified Payment Abstraction: Design a PaymentRequest/PaymentResult interface with idempotency keys, card tokens, and Shva CreditType codes (regular installments=8, credit=6, club installments=9). - Routing & Fallback Logic: Implement feature-based, cost-based, and availability-based routing with the critical rule of never retrying a bank decline on another gateway. - Use Case: A merchant needs to accept 10 interest-free installments with failover if their primary gateway goes down. The Skill guides routing installment payments to Cardcom as primary with Tranzila fallback, while calculating the merchant's interest-subsidy cost. ## Quick Start Ask the assistant to design a multi-gateway payment setup for an Israeli merchant with installment support and automatic fallback between Cardcom and Tranzila.

Frequently Asked Questions about israeli-payment-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate multiple Israeli payment gateways with fallback?

Build a unified PaymentRequest abstraction, then route by feature support, health status, and cost. Retry only on gateway technical errors like timeouts, never on bank declines, and always use idempotency keys to prevent duplicate charges across gateways.

Which Israeli payment gateway supports installments and Bit payments?

PayMe and Meshulam support Bit; Cardcom and Pelecard support all installment types including club. Cardcom, Tranzila, PayMe, iCredit, and Pelecard support regular and credit installments, while Meshulam supports only regular installments.

What are the Shva CreditType codes for Israeli installments?

Shva CreditType codes are: 1=regular, 6=credit installments (קרדיט, interest to bank), 8=regular installments (תשלומים, merchant-financed), and 9=club installments. CreditType is a distinct field from transaction type, and interest-free installments use code 8 with the merchant subsidizing interest.

Cardcom vs Tranzila vs PayMe: which gateway should I choose?

Cardcom offers full installment support including club at 0.6-0.8% fees, Tranzila is a veteran provider with lower 0.5-0.7% fees but no club installments, and PayMe adds Bit and Apple Pay at higher 0.7-1.0% fees. Run the compare_gateways.py script with your volume for a cost estimate.

Why should I never retry a declined payment on another gateway?

A bank decline means the customer's card was rejected for reasons like insufficient funds or a stolen card, so routing it elsewhere will also fail and may trigger fraud flags. Only retry on gateway technical errors such as timeouts or API failures.

What regulations apply to payment processing in Israel?

Non-bank payment service providers are regulated by the Israel Securities Authority under the Regulation of Payment Services and Payment Initiation Law 5783-2023, while the Bank of Israel supervises banks, credit-card companies, and the Shva clearing network. You must retain transaction data for 7 years, use PCI DSS tokenization, and implement 3DS2 for card-not-present transactions.