使用CyberSource Secure Acceptance API，Capture request endpoint是什么？

一、Capture 请求端点基础信息 #

• 端点URL：按环境区分：
  • 测试环境：https://apitest.cybersource.com/pts/v2/payments/{payment_id}/captures
  • 生产环境：https://api.cybersource.com/pts/v2/payments/{payment_id}/captures
• 请求方法：POST
• 认证方式：使用商户ID与签名密钥生成JWT，通过HTTP请求头Authorization: Bearer {JWT_TOKEN}传递（此JWT为API身份认证令牌，非你已生成的支付token）

二、Capture 请求核心参数（JSON格式） #

结合你已完成的Tokenization操作，请求需包含以下关键字段：

{
  "amount": {
    "total": "100.00",
    "currency": "USD"
  },
  "paymentInformation": {
    "tokenizedPayment": {
      "id": "你的支付token值"
    }
  }
}

• amount.total：需捕获的金额，可等于或小于原授权金额（支持部分捕获）
• amount.currency：遵循ISO 4217标准的货币代码
• paymentInformation.tokenizedPayment.id：你在CyberSource Dashboard中查到的支付token

三、Refund 请求端点（补充） #

若需退款操作，端点信息如下：

• 端点URL：
  • 测试环境：https://apitest.cybersource.com/pts/v2/payments/{payment_id}/refunds
  • 生产环境：https://api.cybersource.com/pts/v2/payments/{payment_id}/refunds
• 请求方法：POST
• 核心参数示例：

{
  "amount": {
    "total": "50.00",
    "currency": "USD"
  },
  "paymentInformation": {
    "tokenizedPayment": {
      "id": "你的支付token值"
    }
  }
}

四、关键注意事项 #

• 捕获操作需在原授权交易的有效期内执行（通常为30天，具体以CyberSource规则为准）
• 部分捕获后，剩余授权金额会自动释放，无法再次捕获
• 退款操作需关联已完成的捕获交易，请求中的payment_id为捕获返回的交易ID

内容的提问来源于stack exchange，提问作者IamBB