跳转到主内容

管理伙伴(商人)

A 合伙人 in 4pay.online 术语是一个商家——一个通过您的平台接受付款的企业。合作伙伴有自己的孤立的工作空间:自己的交易, API 键、余额和伙伴区域接入。

创建伙伴​

Via 管理控制台​

  1. Go to 伙伴 + 新伙伴
  2. 填写所需字段 :
    • 名称 - 公司或商号名称
    • 登录 ——合作伙伴区域访问的唯一登录
    • 密码 ——临时密码(合作伙伴在第一次登录时应当更改).
    • 电子邮件 通知的电子邮件联系方式
  3. 指派 终端 ——该合伙人可以使用哪家支付提供者
  4. 配置 Webhook 默认 (可选) – 通知_ url 模板（标识符：notify_url）
  5. 单击 保存

via 管理员 API​

curl -X POST https://4pay.online/api/v1/partners \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -d '{
    "name": "Acme Online Store",
    "login": "acme_store",
    "pass": "temporary-password-123"
  }'

答复:

{
  "id": 42,
  "name": "Acme Online Store",
  "login": "acme_store",
  "created_at": "2026-03-01T10:00:00Z"
}

管理伙伴终端​

终端定义一个伙伴可以使用的支付提供者。每个终端是一个配置到一个支付提供者的连接。

指定终端给合伙人​

curl -X POST https://4pay.online/api/v1/terminal \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -d '{
    "name": "Stripe USD",
    "partner_id": 42,
    "provider": "stripe",
    "type": "payment",
    "is_active": true,
    "env": "prod",
    "provider_params": {
      "api_key": "sk_live_..."
    },
    "merchant_adapter": "merchant_default"
  }'

关键终端字段 :

外地说明
provider提供者适配器名称(见 提供者目录)
typepayment, payout, or merchant (仅发出通知)
envprod or test
provider_params特定供应商的证书和设置
merchant_params通知设置( tg_ids_ to_ notify 等)（标识符：tg_ids_to_notify）

API 关键管理​

每个伙伴都需要一个 API 用于认证请求的密钥。您创建并管理 API 来自行政控制台的密钥。

创建一个 API 密钥​

curl -X POST https://4pay.online/api/v1/api_keys \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ADMIN_TOKEN" \
  -d '{
    "name": "Production Key",
    "partner_id": 42
  }'

对策包括关键价值—— 安全存储,只显示一次。

撤销 a API 密钥​

在行政控制台: 合作伙伴 + [合伙人] → API 键 + 撤销

或者通过 API:

curl -X DELETE https://4pay.online/api/v1/api_keys/KEY_ID \
  -H "Authorization: Bearer ADMIN_TOKEN"

合伙人限制​

设定每个伙伴的支出和速度限制,以管理风险:

限制类型说明
** 每笔交易最大额**每笔交易的最高金额
每日限制每天最大总量
月限每个日历月最大总量
速度每分钟/小时最多交易次数

配置在 管理控制台 + 伙伴 → 管理控制台 + 伙伴 + 管理控制台 + 管理控制台 + 伙伴 管理控制台 + 管理控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 [合伙人] − 限度,或者通过限制 API.

监测伙伴活动​

每个合伙人的交易视图​

在管理控制台,去 合作伙伴 + [合伙人] − 交易 以全过滤方式查看该合伙人的所有交易。

合作伙伴统计数据​

curl "https://4pay.online/api/v1/transactions?partner_id=42&status=charged&from=2026-03-01" \
  -H "Authorization: Bearer ADMIN_TOKEN"

通知​

配置合作伙伴活动的电报或电子邮件通知 :

  • 超过门槛值的大宗交易
  • 负收入(费 > 金额)
  • 每日摘要
  • 交易突变失败

解除伴侣的功能​

在不删除其数据的情况下暂时中止一个合伙人:

  1. Go to 管理控制台 + 伙伴 → 管理控制台 + 伙伴 + 管理控制台 + 管理控制台 + 伙伴 管理控制台 + 管理控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 控制台 [合伙人]
  2. 切换 活动 关闭
  3. 全部人员 API 与该合伙人的证书有关的申请将退回 403 Forbidden

随时通过转回Active来恢复活动.