信用卡支付
拥有在线网站（如在线商城/票务网站/充值网站等）的商户，如果希望支持国际信用卡付款，可以接入本节提供的信用卡支付产品。
信用卡支付是 PayCloud 在线收银台的一种支付方式：商户下单时指定信用卡支付，用户在商户页面选择信用卡支付后，浏览器自动跳转到 PayCloud 在线收银台，用户在收银台输入卡信息完成支付。
用户完成支付后，商家可以收到PayCloud的支付通知，商家也可以主动调用查询订单接口获取支付结果。在获得付款结果后，PayCloud会同步并更新订单信息给商户，以完成剩余的商品和服务。
支持卡组织：JCB、VISA、Mastercard、American Express、Diners、Discover 等。
支持的交易类型：消费（Consumption）、撤销（Cancellation）、退款（Refund）、预授权（ PreAuth）等。
| 终端类型 | 场景 | 说明 |
|---|---|---|
WEB | 电脑网页支付 | 商户网站在 PC 浏览器打开，跳转收银台完成支付 |
WAP | 手机网页支付 | 商户网站在手机/平板浏览器打开，跳转收银台完成支付，需传 os_type |
集成说明
- 不需要自行开发卡信息录入页面。卡号、有效期、安全码等敏感信息全部在 PayCloud 收银台内输入，商户系统不接触敏感卡数据，有利于降低商户的 PCI DSS 合规负担。
- 下单时
pay_method_id请传CreditLinkPay（信用卡支付的统称）。不要传卡品牌（Visa/MasterCard/JCB 等）作为支付方式，用户实际使用的卡品牌由收银台根据卡号（BIN）自动识别。 - 3D Secure（3DS）验证由收银台自动完成，无需商户额外开发；当发卡行要求持卡人验证时，收银台会引导用户完成验证后再继续支付。
- 用户完成支付后，商家可以收到PayCloud的支付通知，商家也可以主动调用查询订单接口获取支付结果。
- 请确保调用此接口时已经开通对应产品权限。
信用卡支付暂不支持指定 sub_pay_method_id。如需支持特定卡组织的营销活动或分期，请联系商务开通后再评估。
交互细节
收银台页面示意
支付流程
步骤1：用户在商户网站选择商品下单，进入支付环节，在支付方式列表中选择「信用卡支付（Credit Card）」。商户后台调用电脑/手机网页支付下单接口（pay_method_id = CreditLinkPay、terminal_type = WEB/WAP），获取收银台跳转地址。
步骤2：商户页面跳转（或新窗口打开）到 PayCloud 在线收银台。收银台左侧展示订单详情：商户名称/门店、订单号（交易号）、创建时间（下单时间）、备注（商品描述）、订单金额（支付金额）；右侧为信用卡支付表单。
步骤3：用户输入卡信息：卡号（输入过程中收银台根据 BIN 识别卡品牌并高亮对应图标）、有效期（月/年下拉框）、安全码（CVV/CVC，输入框带帮助提示）、持卡人姓名。
步骤4：用户点击「去支付」。若发卡行要求 3D Secure 验证，页面将跳转至发卡行验证页面（短信验证码/APP 确认等），用户完成验证后自动返回。
步骤5：支付完成后，收银台展示支付结果页；若下单时传入了 return_url，用户将被重定向回商户页面，商户可据此展示个性化订单处理结果。
步骤6：PayCloud 向商户后台发起异步支付结果通知（notify_url），以通知结果作为最终入账依据。
支付结果获取（双通道）
- 异步通知：交易完成后 PayCloud 向
notify_url发送交易结果通知，商户验签后更新订单状态，并按约定返回应答。 - 主动查询：未收到通知、通知延迟或用户中途关闭页面时，调用查询 支付订单确认最终状态。
不要以收银台页面的同步跳转（return_url）作为支付成功的判断依据，同步跳转可能因用户中途关闭浏览器而丢失。
开发指引
API列表
我们提供了一组REST API，请参阅下表，这些API提供了几种语言的SDK，请访问SDK章节。
| API名称 | 说明 |
|---|---|
| 电脑/手机网页支付下单 | 通过此api提交付款订单，指定 pay_method_id = CreditLinkPay |
| 取消订单 | 通过此api关闭未付款订单，如果已经付款，则向用户退款 |
| 提交退款申请 | 如果您通过此API提交退款请求，但退款没有立即到达，您可以调用退款查询API来获取退款的进度。 |
| 查询支付订单 | 通过该API查询正向交易订单的交易结果（消费/预授权/预授权完成） |
| 查询退款订单 | 通过此API查询退款交易订单（消费取消/消费退款等）的交易结果 |
| 交易结果通知 | 交易完成后，通知商家，告知商家交易结果 |
下单接口关键参数（信用卡支付相关）
完整参数定义请参阅下单API文档，与信用卡支付直接相关的参数如下：
| 参数 | 必填 | 取值 / 说明 |
|---|---|---|
pay_method_id | 是 | 固定传 CreditLinkPay（信用卡支付统称），不要传卡品牌 |
terminal_type | 是 | WEB=PC 网页收银台；WAP=移动网页收银台 |
os_type | WAP 时必填 | ANDROID / IOS |
merchant_order_no | 是 | 商户系统内部订单号，商户下唯一 |
price_currency | 是 | ISO-4217 三位币种，如 JPY、CNY |
order_amount | 是 | 订单金额；JPY 无小数位，只允许正整数 |
expires | 是 | 订单支付有效期（秒），不超过 12 小时 |
description | 是 | 商品描述，展示在收银台「説明」栏 |
notify_url | 建议 | 异步支付结果通知地址 |
return_url | 建议 | 支付完成后用户回跳的商户页面地址 |
language | 建议 | 收银台默认展示语言：ja-JP / en-US / zh-CN |
term_ip / longitude / latitude | 建议 | 风控参数，当前选填，建议提前传入以兼容后续风控要求 |
注意事项
- 支付方式取值：请统一使用
CreditLinkPay。卡品牌由收银台按 BIN 自动识别，无需（也不应）按品牌拆分下单入口。 - 有效期设置：
expires为支付订单有效期（非业务订单有效期），超时未支付订单将被关闭；请结合库存占用策略合理设置。 - 金额规范：JPY 币种只允许正整数金额，避免小数导致下单失败或金额误差。
- 结果处理：以异步通知 + 主动查询双通道确认支付结果；通知需验签并做幂等处理。
- 退款/ 撤销：当日交易可通过取消订单接口撤销；隔日或需要部分退款时使用退款申请接口，退款到卡时效依发卡行而定（一般 1~10 个工作日）。
- 安全合规：商户系统禁止存储、传输卡号/有效期/安全码等敏感数据，一律由paycloud收银台采集。