> For the complete documentation index, see [llms.txt](https://docs.supefina.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supefina.net/huan-ying-shi-yong-supefina-de-api-wen-dang/geng-xin-ji-lu.md).

# 更新记录

## 2025-**10-28** <a href="#id-2023-7-7" id="id-2023-7-7"></a>

**墨西哥代付银行列表变更，变更如下：**

* 新增支持银行&#x20;

<table><thead><tr><th width="96">bankId</th><th width="170.9091796875">bankName</th></tr></thead><tbody><tr><td>2001</td><td>BANXICO</td></tr><tr><td>90903</td><td>CoDi Valida</td></tr><tr><td>90734</td><td>FINCO PAY</td></tr><tr><td>40167</td><td>HEY BANCO</td></tr><tr><td>90721</td><td>ALBO</td></tr><tr><td>90729</td><td>Dep y Pag Dig</td></tr></tbody></table>

* 原银行名称调整&#x20;

90661，原名称ALTERNATIVOS**调整为Klar**

90732，原名称Peibo**调整为PEIBO**（小写改为大写）

## 2025-**7-25** <a href="#id-2023-7-7" id="id-2023-7-7"></a>

修正示例

添加签名组装字符串

哥伦比亚、智利、巴西 响应参数添加了orderExpirationTime 渠道收银台过期时间

秘鲁 Transfer、Cash、Wallet 添加 description 参数

## 2025-**7-18** <a href="#id-2023-7-7" id="id-2023-7-7"></a>

&#x20;修正全部国家的回调通知的identifier字段和描述

## 2025-6-13 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

智利放款接口增加 bankName

## 2025-6-11 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

修改访问沙箱环境的地址从ip改成域名

## 2025-2-11 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2025-2-11

#### 【新增】

巴西代收&代付`customerIdentification`用户证件号由必填调整为非必填。

哥伦比亚代付产品`Transfer`新增必填参数`description`、`bankId`。

## 2025-1-20 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2025-1-20

#### 【新增】

* 智利代收新增字段

`customerName`

`lastName`

`customerIdentification`

`customerIdentificationType`

* 智利代付新增字段

`customerIdentificationType`

`accountType`新增类型 `07`VISTA ，`08`SALARY ACCOUNT

* 智利代付银行列表新增以下银行：

<table><thead><tr><th width="119">bankId</th><th width="181">bankName</th><th width="258">Note</th></tr></thead><tbody><tr><td>027</td><td>Itau-Corpbanca</td><td>新增</td></tr><tr><td>031</td><td>Hsbc Bank</td><td>新增</td></tr><tr><td>057</td><td>Banco Paris</td><td>新增</td></tr><tr><td>0152</td><td>Prepago Los Heroes</td><td>新增</td></tr><tr><td>0738</td><td>Global 66</td><td>新增</td></tr></tbody></table>

## 2025-1-14 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2025-1-15

墨西哥代收Card支付请求参数新增`customerName`和`description`

## 2024-12-25 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-12-25

[哥伦比亚代付](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-fu/ge-lun-bi-ya/transfiya.md) `Transfiya`支付请求参数`accountType`设置为**必填**.

## 2024-12-23 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-12-24

#### 【新增】

哥伦比亚新增代收支付产品[`Bancolombia`](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-shou/ge-lun-bi-ya.md)  （payProduct=28）

## 2024-11-29 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-11-29

#### 【新增】

[交易查询](/huan-ying-shi-yong-supefina-de-api-wen-dang/cha-xun/jiao-yi-cha-xun.md)接口响应参数新增`stampTime`、 `clave`、`errorMsg`

<figure><img src="/files/EcCQlXURxKmGhuG2nEyU" alt=""><figcaption></figcaption></figure>

## 2024-11-26 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-11-26

#### 【新增】

[厄瓜多尔代付](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-fu/e-gua-duo-er.md)Transfer的payProduct修订为12，即payProduct=12；

原Transfer调整为EC Transfer，payProduct=25。

## 2024-11-19 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-11-20

#### 【新增】

* [哥伦比亚](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-shou/ge-lun-bi-ya.md)代收新增参数`description`

## 2024-11-13 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-11-13

#### 【新增】

* 各国家[测试参数](/huan-ying-shi-yong-supefina-de-api-wen-dang/zi-dian-he-zi-yuan/ce-shi-can-shu.md)（包含测试商户ID和Key信息）
* 路径：`字典和资源`——`测试参数`

## 2024-10-9 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-10-9

#### 【新增】

* 巴西支付产品PIX新增customerIdentification参数(cpf)

<table><thead><tr><th>变量名</th><th width="288">类型</th><th>必填</th><th>描述</th></tr></thead><tbody><tr><td>customerPhone</td><td>String</td><td>否</td><td>手机号</td></tr><tr><td>customerIdentification</td><td>String</td><td>是</td><td>用户证件号（CPF）</td></tr></tbody></table>

## 2024-10-8 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-10-8

#### 【新增】

* 墨西哥支付产品[Card](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-shou/mo-xi-ge/card.md)新增卡信息的测试数据

## 2024-9-27 <a href="#id-2023-7-7" id="id-2023-7-7"></a>

#### 修订记录生效日期：2024-10-8

#### 【新增】

* 墨西哥支付产品[Card](/huan-ying-shi-yong-supefina-de-api-wen-dang/dai-shou/mo-xi-ge/card.md)支付请求新增以下参数：

| 变量名                  | 类型      | 必填 | 描述                                                                                                                                                |
| -------------------- | ------- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| productName          | String  | 是  | 商品名称 最大50个字符                                                                                                                                      |
| productQuantity      | Integer | 否  | 商品数量 范围\[0,1000]                                                                                                                                  |
| email                | String  | 否  | 顾客邮箱 3-256个字符 **电商行业必传**                                                                                                                          |
| receiverAddressMain  | String  | 否  | 收件地址，街道 0-50个字符 **电商行业必传**                                                                                                                        |
| receiverAddressExtra | String  | 否  | 收件地址，小区，门牌号 0-50个字符 **电商行业必传**                                                                                                                    |
| receiverCity         | String  | 否  | 收件人城市 0-50个字符，可包括空格、连字符、撇号、逗号和点 **电商行业必传**                                                                                                        |
| receiverProvince     | String  | 否  | 收件人所在省 0-40个字符 参数：<https://en.wikipedia.org/wiki/ISO_3166-2> 例：NY **电商行业必传**                                                                      |
| receiverCountry      | String  | 否  | 收件人国家 参照：[字典表-国家编号](https://docs.supefina.net/huan-ying-shi-yong-supefina-de-api-wen-dang/zi-dian-he-zi-yuan/zi-dian-biao#afwzp) 例：BRA **电商行业必传** |
| receiverZipCode      | String  | 否  | 邮政编码 0-12个字母或数字 **电商行业必传**                                                                                                                        |
| receiverPhone        | String  | 否  | 收件人电话 5-20个字符，区添加区号。如：+1 111111111 **电商行业必传**                                                                                                     |
| alias                | String  | 否  | 用户名 0-60个字符 **游戏行业必传**                                                                                                                            |
| newUser              | Boolean | 否  | 是否一个月内的用户 true：新用户 false：老用户 **游戏行业必传**                                                                                                           |
| hasDispute           | Boolean | 否  | 是否有过历史争议，包含以下任一条： 1、利用作弊工具、游戏漏洞等进行不正当行为； 2、骚扰其他玩家、进行恶意行为或破坏游戏体验的行为； 3、玩家有不当言论、违反游戏规则、频繁被举报； true：有过 false：没有 **游戏行业必传**                           |
| hasRefund            | Boolean | 否  | 是否有过退款 true：有过 false：没有 **游戏行业必传**                                                                                                                |
| hasSingedLong        | Boolean | 否  | 注册时间是否超过三个月 true：超过 false：未超过 **游戏行业必传**                                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.supefina.net/huan-ying-shi-yong-supefina-de-api-wen-dang/geng-xin-ji-lu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.