Stone 企业与商户金融接口集成服务（PIX / Maquininha / Conta PJ）

交付清单

• 协议分析报告（端到端 HTTP/GRPC 流程、鉴权与签名链路）
• OpenAPI（Swagger）规范与示例请求/响应
• 可运行源码（Node.js / Python / Go）含 SDK、Webhook 验证与自动对账脚本
• 自动化测试脚本、Mock Server 与 Postman 集合
• 部署与安全说明（JWT/HMAC 签名、证书管理、IP 白名单）
• 合规建议（LGPD/GDPR/PCI-相关注意点与数据保留策略）

接口示例（伪代码）

// 接收 Stone Pix Webhook（伪代码）
POST /webhook/stone/pix
Headers:
  X-Stone-Signature: <signature>
  Content-Type: application/json

Body: {
  'event': 'pix.received',
  'data': {
    'txid': 'PIX123456',
    'amount': 1500.00,
    'payer_alias': '+5511999999999',
    'merchant_id': 'MCH_001',
    'timestamp': '2025-10-18T14:23:00Z'
  }
}

// 处理流程：
// 1. 验签(X-Stone-Signature) 2. 校验幂等（txid） 3. 入账 -> 返回 200 OK

// 示例：验证签名 (Node.js)
const crypto = require('crypto')
function verifySignature(secret, rawBody, signature) {
  const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex')
  return expected === signature
}

重点场景

商户收单整合（POS/maquininha）、Pix 即时结算、分账规则（split settlement）、批量对账、自动退款与手续费计算、支付失败重试与事务补偿。

API 集成说明（快速上手）

1. 提供目标场景：PIX 收单 / Maquininha / Conta PJ 对账 / 分账等。
2. 我们进行协议与流量采样（若客户有测试或生产凭证，优先使用）。
3. 设计 API：鉴权方式（OAuth2 JWT 或 HMAC）、Webhooks 与回放策略、幂等与重试规则。
4. 实现 SDK 与示例：Node.js/Python + Docker 部署脚本，并提供本地 Mock Server 进行联调。
5. 交付：OpenAPI、源码、测试用例、部署手册与合规建议。

安全与合规要点

• Webhook 签名校验（HMAC-SHA256）与时间容差
• 敏感数据最小化存储（PAN、卡号仅作指纹/掩码）
• PCI/PSD2/LGPD 合规建议（根据客户目标市场定制）
• 日志与审计：不可变事件日志、请求/响应掩码

关于我们

我们是专注于 App 协议分析与授权 API 集成的技术工作室，团队成员来自支付、银行与云端安全背景，擅长将移动 App 的能力以合规、安全的方式暴露为可用 API 与 SDK，支持巴西、欧盟、北美等地区合规要求。

• 领域经验：收单、Pix、账户即服务、POS/maquininha 对接
• 交付内容：协议分析 → 开发 → 测试 → 文档 → 部署
• 平台支持：Node.js / Python / Go + Docker / Kubernetes 部署
• 起步服务：$300（含初步协议分析与 PoC 方案）；按需定制报价

联系方式

立即开始：请通过下方链接提交目标 App 名称与具体需求（示例：Pix 收单 + Maquininha 支付同步 + 日终对账自动化）。

访问联系方式 / 提交需求

合作流程

1. 提交需求（目标 App 名称、场景描述、是否有测试/生产凭证）。
2. 协议分析与方案（2-5 个工作日，含风险点与合规建议）。
3. 开发与联调（3-10 个工作日，取决复杂度）。
4. 交付：源码、OpenAPI、测试脚本与部署指南。
5. 后续支持与 SLA 可选（按月或按项目计费）。

常见问题

Q：我需要提供哪些信息？

Q：如何保证合规？