信用卡 API 介绍
大约 1 分钟
文档语言
信用卡 API 文档目前提供英文与中文；印尼语、泰语版本后续补充。
接口文档导航
| 模块 | 文档 |
|---|---|
| 交易 | 收款（Pay-in） |
| 查询 | 余额查询 · 交易状态 |
| 支付方式 | 支付方式 |
环境配置
| 环境 | 协议 | 媒体类型 | 基础 URL |
|---|---|---|---|
| 沙盒 | HTTPS | application/json | https://sandbox-gateway.smilepayz.com |
| 生产 | HTTPS | application/json | https://gateway.smilepayz.com |
API 概述
信用卡支付网关 API 仅支持代收（Pay-in），支持 USD 与 EUR 下单币种。与法币地区文档结构一致，但商户收款 API 无需传入卡号、CVV、账单地址；下单后返回平台收银台链接，持卡人在 SmilePayZ 收银台填写卡信息与账单信息。
主要特点
- 下单币种：USD（地区码
40）、EUR（地区码41） - 卡组织：Visa、Mastercard（以商户开通为准）
- 精简入参：订单号、商户、金额即可，无需传
paymentMethod，也不传卡号、CVV、账单地址 - 平台收银台：信用卡代收统一返回
channel.paymentUrl，在收银台完成支付 - 仅代收：不支持代付、法币提现
- 企业级安全：HTTPS、请求签名、回调验签
收银台样式（Logo、主题色）见 收银台设置指南。