npulidom/tbk-webpayplus

Transbank Webpay Plus

Transbank Webpay Plus API的容器服务，使用MongoDB作为数据库存储，用于便捷集成Transbank Webpay Plus支付解决方案。依赖MongoDB v6+和Transbank SDK v6.x。

安全提示：出于安全考虑，避免在客户端应用中直接暴露此API。

https://github.com/npulidom/tbk-webpayplus

环境变量

yml
MONGO_URL: MongoDB URL，必填（例如 mongodb://mongo/app）
BASE_URL: 云部署的基础URL，支持URL路径（例如 https://myservices.com/tbk-webpayplus/）
API_KEY: 服务API密钥（必填）
ENCRYPTION_KEY: URL加解密密钥（可选，必须为32字符长度）
TBK_CODE: 生产环境Webpay Plus商店代码（即商户代码，código comercio）
TBK_KEY: 生产环境Webpay Plus API密钥
TBK_SUCCESS_URL: 支付成功跳转URL
TBK_FAILED_URL: 支付失败跳转URL
DEBUG_LOGS: 在生产环境中启用调试日志

使用方法

拉取镜像

bash
docker pull npulidom/tbk-webpayplus

运行容器

bash
docker run -p 8080:80 --env-file .env npulidom/tbk-webpayplus

API端点

请求头

• Content-Type: application/json
• Authorization: Bearer {token}（可选）

GET /health

服务健康检查端点。

bash
curl -i https://{host}/health

POST /trx/create

创建交易端点。

请求体参数

• buyOrder string：订单号
• sessionId string：会话ID
• amount number：交易金额

请求示例

bash
curl -iX POST -H 'Content-Type: application/json' -H 'Authorization: Bearer {API-KEY}' -d '{ "buyOrder": "240830VHY3", "sessionId": "66d19c1d8ef6c3a5d452d715", "amount": 15000 }' {BASE_URL}/trx/create

POST /trx/refund

交易退款端点。

请求体参数

• buyOrder string：订单号
• authCode string：授权码
• amount number：退款金额

请求示例

bash
curl -iX POST -H 'Content-Type: application/json' -H 'Authorization: Bearer {API-KEY}' -d '{ "buyOrder": "12345678", "authCode": "123456", "amount": 800 }' {BASE_URL}/trx/refund

响应格式

javascript
// 成功响应
{
    "status": "ok",
    ...payload
}

// 错误响应
{
    "status": "error",
    "error": "SOME_ERROR"
}

测试

集成测试数据

text
# 信用卡
4051885600446623（成功）
5186059559590568（失败）
CVV: 123

# 借记卡
4051884239937763（成功）
5186008541233829（失败）

# 预付卡
4051886000056590（Visa成功）
5186174110629480（Mastercard成功）
CVV: 123

# 认证登录
用户: 11111111-1
密码: 123

端点测试步骤

1. 获取交易令牌示例：

sh
curl -iX POST -H 'Content-Type: application/json' -H 'Authorization: Bearer some-secret' \
-d '{ "buyOrder": "240830VHY3", "sessionId": "66d19c1d8ef6c3a5d452d715", "amount": 15000 }' http://g-tbk-webpayplus.localhost/trx/create

2. 使用test/init.html示例表单（通过http-server node包暴露test文件夹）：

sh
~ cd test
~ http-server

3. 在浏览器中访问http://localhost:8080/init.html?token={token}，传入上一步获取的令牌。

参考

• Transbank Webpay Plus文档