> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常问问题

查找有关支付、API 集成和 Localpayment 服务的常见问题的答案，帮助您更快地排除故障并随时了解最新信息。

立即获取有关 Localpayment 最常见问题的解答。本资源涵盖集成、支付处理、账户管理和故障排除。

## 集成

> [accordion] 与 Localpayment 集成需要多长时间？
>
> 大多数商户可在 1-2 周内完成集成，
> 具体取决于其技术资源和实施的复杂程度。
> 我们文档完善的 API 有助于加快这一进程。

> [accordion] 有哪些不同的集成选项？
>
> Localpayment 提供多种集成选项：
>
> * **API 集成**：通过我们的 REST API
>   完全掌控支付流程
> * **Web Checkout**：将客户重定向
>   至我们托管的支付页面
> * **Smart Fields**：在您的结账页面中嵌入
>   安全支付字段
>
> 请根据您的技术能力、PCI DSS 合规
> 要求以及期望的用户体验进行选择。

> [accordion] 你们提供SDK或客户端库吗？
>
> 目前，我们提供功能全面的 REST API，并附有详细的文档和示例。虽然我们目前不提供官方 SDK，但我们结构良好的 API 旨在轻松与任何编程语言集成。

> [accordion] 如何在上线前测试我的集成？
>
> 使用我们的测试环境，其中包含测试凭证，例如测试卡号、银行账户、模拟 Webhook 和完整的测试文档。我们建议您在正式部署前，对所有支付方式和错误场景进行全面测试，以确保您的集成能够正确处理所有可能的情况。

> [accordion] 测试环境和生产环境有什么区别？
>
> **测试环境**：
>
> * 仅用于测试和开发
> * 没有实际的资金交易。
> * 完整的 API 功能
> * 测试数据和模拟响应
>
> **生产环境**：
>
> * 实时支付处理
> * 真实金融交易
> * 更高的安全要求
> * 受服务水平协议 (SLA) 保障的性能

***

## 付款

> [accordion] Localpayment 支持哪些支付方式？
>
> 我们支持拉丁美洲地区多种多样的支付方式：
>
> **银行卡**：Visa、万事达、美国运通卡以及本地卡组织银行\
> **转账**：Debin（阿根廷）、Pix（巴西）等\
> **电子钱包**：Wallet Fri 等\
> **虚拟账户**：用于银行转账的专用账号
>
> 不同国家/地区可用的方法有所不同 - 请查看我们的国家/地区覆盖范围文档以了解具体信息。

> [accordion] 货币兑换是如何进行的？
>
> Localpayment 会自动处理货币转换：
>
> * 接受以当地货币支付
> * 以您偏好的货币（美元、欧元等）结算。
> * 具有竞争力的汇率，价格透明。
> * 可通过 API 获取实时外汇汇率

> [accordion] 你支持哪些国家？
>
> 我们目前支持以下国家/地区的业务运营：
>
> * 阿根廷
> * 玻利维亚
> * 巴西
> * 智利
> * 哥伦比亚
> * 哥斯达黎加
> * 危地马拉
> * 洪都拉斯
> * 墨西哥
> * 巴拿马
> * 巴拉圭
> * 秘鲁
> * 多明尼加共和国
>
> 我们正在不断拓展新市场。请联系我们的销售团队，了解即将推出的国家/地区。

> [accordion] 付款需要多长时间才能到账？
>
> 处理速度因支付方式而异。银行卡支付通常即时授权，而银行转账可能需要更长时间，具体取决于银行网络，电子钱包通常处理速度很快。款项结算到您的银行账户遵循每种支付方式的标准时间。

> [accordion] 交易限额是多少？
>
> 交易限额根据您的验证级别、使用的支付方式、当地法规以及持续的风险评估而有所不同。您在注册时将获得默认限额，随着业务增长，您可以申请更高的限额。要查看您当前的限额，请访问您的企业门户或联系我们的支持团队。

***

## 账户与账单

> [accordion] 如何创建 Localpayment 账户？
>
> 要创建 Localpayment 账户，您首先需要联系我们的团队，以便我们评估您的业务并启动入驻流程。我们将指导您完成每个必要步骤，包括业务验证、文件提交和合规性审核。入驻审核通过后，我们将激活您的账户并提供 API 凭证，以便您开始集成。

> [accordion] 你们收取哪些费用？
>
> 我们的定价透明且具有竞争力： - **百分比费用**：根据
> 交易量和支付方式而定 - **固定费用**：每笔交易收取
>
> * **外汇汇差**：用于货币兑换（如适用） - **无月费**
>   （标准账户） 入驻期间将根据
>   您的业务模式、交易量和所在国家/地区提供具体定价。
>   如需定制的企业定价，请联系销售团队。

> [accordion] 我如何提取我的资金？
>
> 资金提取方式： - **自动结算**：每日、每周或每月结算至
> 您的银行账户 - **手动提现**：按需发起付款 -
> **本地货币账户**：以本地货币持有资金 - **多币种
> 结算**：以美元、欧元或其他主要货币接收资金 请在商业门户的“账户设置”中
> 配置您的结算偏好。

> [accordion] 账户验证需要哪些文件？
>
> 入驻所需的文档会根据您的业务类型、计划使用的付款方式、运营所在国家/地区以及任何适用的监管义务而有所不同。我们的合规团队将在入驻过程中审核您的信息并提供一份定制的清单，以确保您满足所有必要要求。

***

## 技术

> [accordion] Webhook 的工作原理是什么？我该如何设置它们？
>
> Webhook 为交易事件提供实时通知： 在 Business Portal 中配置
> 您的 Webhook URL 选择要接收的事件（payin、
> payout 等） 使用您的 Webhook 密钥实施签名验证
> 处理包含 JSON 负载的传入 POST 请求 所有 Webhook 均通过
> HTTPS 发送，并包含用于安全验证的签名。 完整的实现细节请参阅我们的 Webhook
> 文档。

> [accordion] 如何处理错误和拒付？
>
> 我们的 API 返回标准化的错误响应： - HTTP 状态码（4xx 表示
> 客户端错误，5xx 表示服务器错误） - 详细的错误代码和消息 -
> 适用时提供针对具体字段的验证错误 请实施适当的错误
> 处理，以显示用户友好的消息并记录错误以便调试。 最佳实践请参阅
> 我们的错误处理指南。

> [accordion] 你们提供用于测试的 Postman 集合吗？
>
> 是的！我们提供完整的 Postman 集合，其中包括： -
> 预配置的测试环境和生产环境 - 所有 API endpoint 的示例请求 -
> 各种场景的测试数据 - 身份验证辅助工具
> 您可从文档网站下载我们的 Postman 集合。

> [accordion] 如何查询交易状态？
>
> 查询交易状态有多种方式： API：使用交易状态
> endpoint 并提供您的外部标识 商业门户：查看实时交易报告
> Webhook：接收自动状态更新 报告：下载每日结算
> 报告 我们建议在您的应用程序中使用 Webhook
> 进行实时状态跟踪。

***

## 安全与合规

> [accordion] Localpayment 是否符合 PCI DSS 标准？
>
> 是的，Localpayment 符合 1 级 PCI DSS 标准——这是支付行业
> 认证的最高级别。这意味着我们在处理支付数据时
> 始终遵循最严格的安全标准。使用我们的 API 或
> Web Checkout 时，您的 PCI DSS 合规范围将大幅缩小。
> 如需针对您的集成方式的合规指南，请联系我们。

> [accordion] 如何保护客户数据？
>
> 我们采用多种安全措施： - 传输中（TLS 1.2+）
> 和静态数据加密 - 使用令牌化替代敏感数据 - 定期安全审计
> 和渗透测试 - 符合 SOC 2 Type II 标准 - 欺诈检测和
> 防范系统 安全是我们平台的根本，我们
> 持续投入以保护您的数据。

> [accordion] 你们提供哪些防欺诈工具？
>
> 我们全面的欺诈防范措施包括： - **3D 安全**：为银行卡支付提供
> 额外的身份验证 - **风险评分**：基于机器学习的
> 欺诈检测 - **速度检查**：监控交易模式 - **IP
> 地理定位**：检测可疑的位置模式。

***

## 支持

> [accordion] 我该如何联系客服？
>
> 技术支持：
> [support@localpayment.com](mailto:support@localpayment.com)

> [accordion] 你们在集成过程中提供技术支持吗？
>
> 是的！我们提供全面的集成支持： - 为客户配备专属技术
> 客户经理 - 集成评审和最佳
> 实践指导 - 代码审查协助 - 测试支持和验证
> 请联系我们的集成团队安排启动会议，并在您的实施
> 过程中获得专属支持。

> [accordion] 哪里可以找到API文档？
>
> 完整文档请访问： - **API 参考**：
> docs.localpayment.com/reference - **集成指南**：
> docs.localpayment.com/docs -
> **Postman 集合**：从文档中下载。

***

## 虚拟账户

> [accordion] 这些虚拟账户是以谁的名义创建的？
>
> 法定账户所有人（银行系统中登记的姓名）因国家/地区而异。下表概述了具体情况：
>
> <table>
>   <thead>
>     <tr>
>       <th>
>         国家/地区
>       </th>
>
>       <th>
>         当地居民
>       </th>
>
>       <th>
>         外国居民
>       </th>
>
>       <th>
>         账户所有者
>       </th>
>
>       <th>
>         别名
>       </th>
>
>       <th>
>         银行转账显示名称
>       </th>
>     </tr>
>   </thead>
>
>   <tbody>
>     <tr>
>       <td>
>         阿根廷
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = 外国居民
>         * **DDA** = 当地居民
>       </td>
>
>       <td>
>         最多可创建 1 个别名
>       </td>
>
>       <td>
>         * **受益人姓名**（如为阿根廷公民，则在创建虚拟账户时提供）
>         * **Localpayment 的法律实体名称**（所有其他情况）
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         巴西
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         * **FBO** = 外国居民
>         * **DDA** = 当地居民
>       </td>
>
>       <td>
>         不适用
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         智利
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         不适用
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         哥伦比亚
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         默认密钥
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         墨西哥
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **DDA** = 当地居民
>       </td>
>
>       <td>
>         不适用
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         秘鲁
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         不适用
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>
>     <tr>
>       <td>
>         哥斯达黎加
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         ✅
>       </td>
>
>       <td>
>         **FBO**
>       </td>
>
>       <td>
>         不适用
>       </td>
>
>       <td>
>         **Localpayment 的法律实体名称**
>       </td>
>     </tr>
>   </tbody>
> </table>

> [accordion] 本地企业的虚拟账户规则是否有所不同？
>
> 不。阿根廷、巴西、智利、哥伦比亚、墨西哥和秘鲁都允许本地居民和外国居民创建虚拟账户。
>
> **对阿根廷而言，一个重要的区别是**：虚拟账户的**合法所有者**（持有人）会根据受益人的居住地而有所不同：
>
> * **对于阿根廷受益人**：该账户的合法所有权归指定的受益人所有。
>
> * **对于外国受益人**：该账户的合法所有权归 Localpayment 的当地实体所有。

> [accordion] 虚拟账户服务的费用是多少？
>
> 虚拟账户服务的费用会根据您的商业协议、交易量和所在国家/地区而有所不同。如需详细了解最新的价格信息，请联系我们的[销售](mailto:sales@localpayment.com)团队。

> [accordion] 虚拟账户和我的Localpayment账户有什么区别？
>
> 这是两种不同的账户类型，在您的支付流程中发挥着不同的作用：
>
> * **您的 Localpayment 内部账户**：这是您的管理和资金主账户。您可以为不同的业务部门或地区设置多个主账户。该账户在注册时创建，用于通过 Business Portal 管理您的所有财务、配置、报告、设置和付款操作。所有通过虚拟账户和其他方式收取的资金最终都会结算到此账户进行资金管理。
>
> * **虚拟账户**：这是 **Payin 产品**。它是一个按需收款账户，功能类似于一个专用的银行账号，用于接收电子银行转账款项。其唯一用途是处理客户的付款。

> [accordion] 我可以跨国家直接向另一个虚拟账户转账吗？
>
> 不，这是不可能的。**虚拟账户仅用于接收资金（充值）**。您无法发起转账或从一个虚拟账户向另一个虚拟账户发送资金。
>
> 资金一旦存入虚拟账户，就会结算到您关联的**内部Localpayment账户**。之后，您可以使用主账户中的相应支付或转账服务，将这些资金（甚至跨国家/地区）进行分配。

***

## 快速故障排除

* **身份验证问题**：检查您的 API 凭证、令牌有效性和 IP 白名单。
* **付款被拒**：请在沙盒环境中验证测试卡，并查看您的账户状态和限额。
* **Webhook 问题**：确保您的 endpoint 使用 HTTPS，验证签名，并返回 200 OK 响应。
* **集成错误**：检查您的 API 日志，在沙盒环境中进行测试，并查阅文档。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.