跳转到主内容

开始——客户端登机

这个导师带你走过设置 4pay.online 从头到尾:从获得权限开始处理您的第一次交易。

步骤 1 ——接收您的管理员证书.​

在签订合同后,您将收到:

  • 管理控制台 URL: https://4pay.online/admin_area/signin
  • 初始管理员登录和密码
  • 你的组织 ID

登录到 管理控制台 ,并在第一个登录时更改密码。

步骤 2 — 配置您的第一个支付提供者​

在接受任何付款之前, 您至少需要配置一个 终端 ——与支付提供商的连接.

  1. 在管理控制台,去 航站楼 — 新航站楼
  2. 从目录中选择一个提供者( 如 Friede, Adyen, 您的本地银行)
  3. 输入该提供者所需的证书( E)API 密钥、商号等)
  4. 设置终端类型 : payment, payout, or both
  5. 设定货币和地域范围
  6. 保存并激活

见 终端运行( R) 以便一个完整的向导, 提供者目录 (c) 向每个提供方提供所需证书。

步骤 3 ——创建你的第一位搭档(商家).​

A 合作伙伴 代表您的一位商人——一个会使用您的支付服务的公司或个人.

  1. Go to 伙伴 + 新伙伴
  2. 输入伴侣姓名、登录证书和联系人信息
  3. 向伙伴指定终端——它们只能通过指定的终端进行交易
  4. 保存并激活

该合作伙伴将收到电子邮件邀请,以访问该平台。 合作伙伴领域 at https://4pay.online/partner_area/signin.

见 管理伙伴 高级伙伴配置。

步骤 4 - 生成一个 API 伴侣的密钥​

每个伙伴都需要一个 API 要制作的密钥 API 电话

  1. Go to 合作伙伴 + [合伙人名称] → API 密钥
  2. 单击 创建密钥
  3. 与伴侣共享密钥—— 仅显示一次

合作伙伴必须在每次 API 请求中同时携带 x-api-key 和 x-organization-id 请求头，后者的值是组织的 UUID。密钥属于特定组织， 单独提供密钥无法通过身份验证。支付端点会返回 401；部分端点对缺少请求头 返回 400。应将密钥和组织标识一起提供给合作伙伴。

步骤 5 - 处理第一次测试交易​

请您的搭档使用沙盒进行测试交易 API 键和测试卡。见 沙盒测试( T) 在伙伴文档中。

或跑快一点 API 烟雾测试:

curl -X POST https://4pay.online/api/v1/session \
  -H "Content-Type: application/json" \
  -d '{"login": "your-admin@example.com", "password": "yourpassword"}'

此次登录有意作为双请求头规则的例外：admin 和 client 会话 不绑定组织，因此此时无需指定组织。例外仅适用于 登录阶段。partner 或 person 会话属于其组织，返回的令牌只有在 请求指定该组织时才能解析。因此每次后续请求都必须携带 x-organization-id；没有它，令牌会被视为未知。person 登录本身也需要 此请求头；partner 登录则可在不携带它时被识别。

用会话符号成功响应确认您的平台已经配置并可以访问 。

步骤 6 ——配置路由规则(可选).​

如果您配置了多个终端, 请设置 智能路径 以自动选择每次交易的最佳提供者 :

  • 按货币划分的路线(例如, EUR 交易 − SEPA 提供者, USD → US 获取卡)
  • 按地域划分的路线(如亚洲交易) – 当地亚洲供应商
  • 按成本划分的路线(例如,首先收费最低者)
  • 失败规则(例如,如果主要提供者失败,在二级上重试)

见 终端运行( R) 用于路由配置。

步骤 7 - 开始生活吧​

在开始直播之前:

  • 所有供应商都经过真实测试 API 证书(不是沙盒)
  • 合伙人 API 为生产重新生成密钥
  • 已部署和核实的 Webhook 端点
  • 审查和测试规则
  • 配置限制和反欺诈规则
  • 设立具有适当作用的管理团队账户

支助​