开始之前

账单 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]。