跳转到内容
PGSwift Docs
文档/电子钱包

电子钱包

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

POST /api/create/ewallet

请求

名称类型必填输入校验描述
merchant_transaction_idstringtrue商户提供的唯一交易标识符
amountstringtrue数字类型，1–12 位交易金额的数值表示。
currencystringtrue可接受的数值："IDR"交易使用的货币（仅支持印尼卢比）。
ewallet_codestringtrue可接受的数值：DANA, OVO, LINKAJA, SPAY, GOPAY交易使用的电子钱包供应商代码
phone_numberstringtrue有效的印尼电话号码（必须以 08 或 628 开头，例如：081234567890 或 6281234567890）客户在电子钱包注册的电话号码
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",
    "ewallet_code": "DANA",
    "phone_number": "081234567890",
    "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.redirect_url 用户重定向链接，用于完成电子钱包支付。此链接会引导用户到付款页面。
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": "EWALLET_DANA",
        "redirect_url": "{host}/checkout/9e536777-2bfa-4161-9931-35f5c4b23faf/ewallet/DANA",
        "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