开始之前
账单 API
Affise API 为您提供了处理账单的不同方法。例如，您可以获取付款发票信息、 创建付款发票、删除 发票等。在本文中，您将找到最常用的账单 API 请求（方法）示例，以及 cURL 示例和响应示例。
💰 API 账单功能 仅适用于某些计划。请联系您的 Affise 客户经理以获得该功能。
获取付款列表
使用此方法可根据您在 API 请求中指明的支付属性获取支付列表。
方法如下GET /3.1/payments.
请求获取指定期限的付款列表：
https://api-rocketcompany.affise.com/3.1/payments?date_from=2022-08-08&date_to=2022-12-12
创建付款发票
使用此方法可根据 API 请求中指定的联属会员属性，为其生成一定金额的账单。
方法如下POST /3.1/payments/create-for-affiliate.
cURL 请求用于创建具有以下属性的付款发票：
联属会员 ID
付款发票金额
货币 ID
curl --location --request POST 'https://api-rocketcompany.affise.com/3.1/payments/create-for-affiliate' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=alcje7al4vd7p27ev26s1gclqm' \--data-urlencode 'aid=2' \--data-urlencode 'sum=2' \--data-urlencode 'currency=150'
为联属会员生成付款发票
使用此方法可根据您可在 API 请求中指明的属性生成特定时间段的账单。
方法如下POST /3.1/payments/generate.
为联属会员创建付款发票的 cURL 请求具有以下属性：
日期
联属会员 ID
排除在外的联属会员 ID
curl --location --request POST 'https://api-rocketcompany.affise.com/3.1/payments/generate' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=alcje7al4vd7p27ev26s1gclqm'\--data-urlencode 'date=2022-05-23'\--data-urlencode 'aid=2'\--data-urlencode 'exclude_aids[]=8'
更新付款发票
使用此方法可根据您在 API 请求中指明的付款发票属性更新付款发票。
方法如下POST /3.1/payments/{ID}。
更新付款发票的 cURL 请求包含以下属性：
付款账户信息
已支付部分状态
curl --location --request POST 'https://api-rocketcompany.affise.com/3.1/payments/2926' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=7e3nrlm566d1vdqdioiaflrhhn'\--data-urlencode 'payment_account=payment account'\--data-urlencode 'status=3'
为付款发票添加修正值
使用此方法可根据您在 API 请求中指明的付款发票属性为其添加修正值。
方法如下POST /3.1/payments/{ID}/add-correction.
添加修正值的 cURL 请求具有以下属性：
收入 = 22
注释
curl --location --request POST 'https://api-rocketcompany.affise.com/3.1/payments/2921/add-correction' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=alcje7al4vd7p27ev26s1gclqm' \--data-urlencode 'revenue=22' \--data-urlencode 'comment=example' （注释=示例
删除多张付款发票
使用此方法可根据您在 API 请求中指明的付款发票属性删除几张付款发票。
方法如下POST /3.1/payments/bulk-delete.
⚠️ 除 "完成 "外，您可以删除任何状态的账单。 如果尝试以 "完成 "状态删除账单，会出现以下错误：
多个付款发票的 cURL 请求删除了付款发票 id = 2925 和 2924：
curl --location --request POST 'https://api-rocketcompany.affise.com/3.1/payments/bulk-delete' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=7e3nrlm566d1vdqdioiaflrhhn' （--data-urlencode 'ids[0]=2925' （--data-urlencode 'ids[1]=2924
编辑支付系统
使用此方法可根据联属会员的属性编辑其支付系统，您可在 API 请求中指明这些属性。
方法如下POST /3.0/admin/partner/{ID}.
⚠️ 只有当账单处于任何状态（完成除外）时，编辑选项才可用。
用于编辑附属系统 ID = 13、货币代码 = 美元和高级字段 = 1b765 的支付系统的 cURL 请求：
curl --location --request POST 'https://api-rocketcompany.affise.com/3.0/admin/partner/2' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'api-key: 5c9f6bbe709c5b331a9630b1fb1db0ed' \--header 'Cookie：PHPSESSID=7e3nrlm566d1vdqdioiaflrhhn' \--data-urlencode 'payment_systems[0][system_id]=13' \--data-urlencode 'payment_systems[0][currency]=USD' \--data-urlencode 'payment_systems[0][fields][4]=1b765'
有关所有问题，请通过电子邮件联系 Affise 客户支持团队：[email protected]。