终端运行( R)

A 终端是您平台和支付提供者之间配置的连接。每个终端都有一个提供商,一个或一个以上支持的货币,以及一组证书。智能路由会自动选择每项交易的最佳终端。

终端类型

类型	说明
`payment`	接受收款付款(收款)
`payout`	发出外出付款(支付)
`merchant`	仅通知——用于网签交付,而非实际支付.

创建终端

Via 管理控制台

管理控制台 / 终端 / 新终端
从目录中选择提供者
输入提供者证书( E)provider_params)
设定类型、货币和地理范围
激活( A)

via 管理员 API

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

提供者证书(提供者_params)（标识符：`provider_params`）

每个供应商都需要不同的证书。提供者目录所需经费 provider_params 每个提供者。

常见模式 :

供应商	所需参数
条纹	`api_key`, `webhook_secret`
亚甸	`api_key`, `merchant_account`, `client_key`
checkout.com (中文(简体) ).	`secret_key`, `public_key`
付费页	`client_id`, `client_secret`

全参数参考 : 提供者目录

商贸通知(商贸-params)（标识符：`merchant_params`）

配置平台如何通知您和交易事件的合伙人 :

{
  "merchant_params": {
    "tg_ids_to_notify": ["123456789", "987654321"]
  }
}

参数	说明
`tg_ids_to_notify`	接收交易通知的电报用户ID

智能路由

智能路由会根据您定义的规则,自动为每次交易选择最佳终端.

路线如何运作

交易抵达时 currency, amount, type,可选择 country
运行引擎为合作伙伴评价所有活动终端
终端是按你的路线规则打的
交易发送到记分最高的终端
如果终端失败, 将试运行链中的下一个终端

规则因素

因素	说明
货币匹配	终端必须支持交易货币
交易类型	终端类型必须匹配( E)`payment` / `payout`)
地理范围	终端可限于特定国家或区域
优先权	明确优先级号——下级=较高优先级.
可用性	仅考虑活动、非降级终端

配置路线规则

In 管理控制台运行规则:

Rule: EUR payments in Europe
  currency = EUR
  region = Europe
  type = payment
  terminal_priority = [stripe_eur, adyen_eur, checkout_eur]

失败

如果一个终端失败(提供错误,超时,或网络问题),平台会在故障翻转链中的下一个终端上自动重试.

配置失败链 管理控制台终端故障:

Primary: stripe_eur
Failover 1: adyen_eur
Failover 2: checkout_eur

多种货币和 FX

以非本国货币进行的交易,由终端自动支持。 FX 可启用转换 :

交易抵达 USD
终端支持 EUR
FX 转换 USD → EUR 市场利率 + 配置差幅
交易处理于 EUR
解决在 EUR 与 FX 入帐金额

配置 FX 分布于 管理控制台 – FX − 比率.

关闭终端

暂时将一个终端下线(例如供应商维护):

行政控制台终端 [终端] - 停止活动
运行引擎将自动跳过此终端
故障终端将处理交通

没有丢失数据。随时重新启动。

终端运行( R)

终端类型​

创建终端​

Via 管理控制台​

via 管理员 API​

提供者证书(提供者_params)（标识符：provider_params）​

商贸通知(商贸-params)（标识符：merchant_params）​

智能路由​

路线如何运作​

规则因素​

配置路线规则​

失败​

多种货币和 FX​

关闭终端​