GoGoPay 介绍

GoGoPay 是一个安全、可靠的支付平台，为开发者提供简单易用的支付解决方案。 通过我们的 API，您可以快速集成多种支付方式，为用户提供流畅的支付体验。

快速开始

按照以下步骤，您可以在几分钟内完成 GoGoPay 的集成：

1. 注册账户

首先，您需要在 GoGoPay 开发者平台注册账户：

  • 访问 开发者控制台：https://dashboard.gogopay.com
  • 提交企业认证信息
  • 等待审核通过

2. 获取 API 密钥

审核通过后，您可以在开发者页面查看您的密钥：

// Java 示例 new okhttp3.Headers.Builder() .add("Authorization", "Bearer {secret_key}");
重要提示： 请妥善保管您的 API 密钥，不要在客户端代码中暴露密钥信息。

API 集成指南

GoGoPay 提供了简洁的 RESTful API，支持多种编程语言。以下是基本的集成流程：

步骤 1：创建支付会话

调用 Create Session API 生成支付链接：

POST /v1/sessions
{ "amount": 1000, "currency": "CNY", "success_url": "https://your-site.com/success", "cancel_url": "https://your-site.com/cancel" }

步骤 2：重定向用户

将用户重定向到返回的支付链接，等待支付完成。

步骤 3：处理支付结果

通过以下方式获取支付状态：

  • Retrieve Session - 查询会话状态
  • Retrieve Payment - 查询支付详情
  • Webhook - 接收实时通知

环境配置

GoGoPay 提供沙箱和生产两套环境：

环境 API 地址 控制台地址
沙箱环境 https://sandbox-api.gogopay.com https://sandbox.gogopay.com
生产环境 https://api.gogopay.com https://dashboard.gogopay.com

保存支付方式

为了让客户避免重复输入卡片信息，GoGoPay 支持保存支付凭证功能：

实现步骤

  1. 调用 Create Customer 获取 customerId
  2. 在 Create Session 时包含 customerId
  3. 设置 paymentMethodOptions.card.setupFutureUsage 为 on_session
{ "amount": 1000, "currency": "CNY", "customer_id": "cus_1234567890", "payment_method_options": { "card": { "setup_future_usage": "on_session" } } }

安全最佳实践

  • HTTPS 通信：所有 API 调用必须使用 HTTPS
  • 密钥管理：将 API 密钥存储在服务器端，不要暴露给客户端
  • 签名验证：验证 Webhook 签名确保数据完整性
  • 幂等性：使用幂等键避免重复处理

错误处理

GoGoPay API 使用标准的 HTTP 状态码。常见错误码：

状态码 含义 处理建议
400 请求参数错误 检查请求参数格式
401 认证失败 检查 API 密钥
429 请求频率过高 实现重试机制
500 服务器错误 稍后重试

下一步

现在您已经了解了 GoGoPay 的基本概念，可以继续学习：