用途:指导在以色列应用中接入 Tranzila 支付网关,受理信用卡支付(slikat kartis ashrai)。Tranzila 自 1999 年运营,连接 Shva 网络,支持 Isracard、Visa Cal、Max 等发卡机构。官方文档:https://docs.tranzila.com/。
主要能力与集成方式:
- Iframe:嵌入 https://direct.tranzila.com/{supplier}/iframenew.php,传 sum、currency、cred_type 等参数,tranmode 选择模式(A 标准扣款、V/J5、N/J2、K 仅建令牌及 AK/VK/NK)。回调参数为 success_url_address、fail_url_address、notify_url_address。
- Hosted Fields:自建结账表单,卡号等由 Tranzila 处理,提交时生成 TranzilaTK 令牌,再经 API V2 扣款。
- API V2(服务端):认证为 4 头 HMAC-SHA256 握手,需 X-tranzila-api-app-key、X-tranzila-api-request-time、X-tranzila-api-nonce、X-tranzila-api-access-token。
令牌化与循环扣款:首次支付时用 tranmode=K/AK/VK 获取令牌,后续用 /cgi-bin/tranzila31tk.cgi 扣款。令牌应视为不透明字符串,勿按长度校验。
以色列特有功能:分期付款 cred_type=8,参数 npay、fpay、spay,且 fpay+(npay*spay) 须等于总额;货币代码 1=ILS、2=USD、978=EUR、826=GBP;myid 为 9 位以色列身份证号,属受监管个人数据。DCdisable 可防重复扣款(需在 my.tranzila 启用,最长 24 小时)。J5 授权需另行 capture(txn_type=force),reversal 释放额度。
其他:3D Secure V2、Bit 支付(仅 NIS、金额需大于 5 NIS、需 Visa 或 Isracard 标识)、支付请求链接(TRAPI)、Standing Orders(付费功能)、发票 API(含以色列税务局分配号要求)。
限制:退款需单独端点与 CreditPass 等凭据;API V2 与 iframe/旧版 CGI 参数名不通用;不得存储 CVV 或完整卡号;沙箱卡号需向 Tranzila 支持索取,勿使用博客流传的测试卡号。具体端点、参数与阈值以官方文档为准。