跳转到内容
PGSwift Docs
文档/银行账户

银行账户

商户可通过此接口创建用于处理交易的结账页面

POST /api/create/bank

请求

名称类型必填输入校验描述
merchant_transaction_idstringtrue商户提供的唯一交易标识符
amountstringtrue数字类型，1–12 位交易金额的数值表示。
currencystringtrue可接受的数值："IDR"交易使用的货币（仅支持印尼卢比）。
bank_codestringtrue可接受的数值：BCA, MDR, BNI, BRI交易使用的银行代码
customer_namestringtrue长度在 5–25 个字符之间，允许字符：a–z、A–Z、0–9、-（短横线）、（空格）与该交易关联的客户姓名
product_namestringtrue长度在 5–25 个字符之间，允许字符：a–z、A–Z、0–9、-（短横线）、（空格）与该交易关联的产品名称
descriptionstringfalse可选的交易补充信息
success_redirect_urlstringfalse付款成功后重定向客户的 URL。也支持移动端深度链接 (Deep Link) URL。
{
    "merchant_transaction_id": "ICZ10000001",
    "amount": "100000",
    "currency": "IDR",
    "bank_code": "BCA",
    "description": "Lorem Ipsum",
    "customer_name": "John Doe",
    "product_name": "Product Test",
    "success_redirect_url": "https://example.com/success"
}

响应

名称 描述
status 请求状态指示器。成功时为 true，失败时为 false
message 请求结果消息。请求成功时通常为 "success"
data.transaction_id 系统生成的唯一交易标识符。
data.account_number 生成的银行账号，供客户用于付款。
data.account_name 账户持有人姓名。
data.amount 用户需要转账的总金额
data.channel 银行账户支付使用的银行或支付渠道。
data.redirect_url 用户重定向链接（如适用）。如无重定向链接，此字段可为 null。
data.expired_at 支付过期时间，服务器时间（UTC+7，无偏移量），格式 YYYY-MM-DD HH:MM:SS（例如 "2025-02-26 19:00:00"）。如不适用则为 null。
data.expired_at_iso 与 expired_at 相同的过期时间，ISO 8601 格式并带偏移量（例如 "2025-02-26T19:00:00+07:00"）。所有渠道格式一致。expired_at 为 null 时为 null。
data.payment_channel 标准化支付渠道，所有支付类型和服务商使用同一格式：例如 QRIS、VA_BRI、BANK_BCA、EWALLET_DANA（支付类型前缀 + 附录中的代码）。无法确定渠道时为 null。建议优先使用此字段而非 channel。
data.success_redirect_url 付款成功后重定向客户的 URL。也支持移动端深度链接 (Deep Link) URL。 
{
    "status": true,
    "message": "success",
    "data": {
        "transaction_id": "9e536777-2bfa-4161-9931-35f5c4b23faf",
        "payment_channel": "BANK_BCA",
        "account_number": "4871002066",
        "account_name": "John Doe",
        "amount": 100089,
        "channel": "BANK_BCA",
        "redirect_url": "{host}/checkout/9e536777-2bfa-4161-9931-35f5c4b23faf/bank/BCA",
        "success_redirect_url": "https://example.com/success",
        "expired_at": "2025-02-26 19:00:00",
        "expired_at_iso": "2025-02-26T19:00:00+07:00"
    }
}

Webhook