为获得最佳效果,建议的设置如下:
- MCP 服务器(主服务器):在您的 AI 工具中配置 Localpayment MCP 服务器。AI 将自动调用
list-endpoints、get-endpoint、search和fetch,用经过验证的实时数据作答。 - LLMs.txt(备用):如果您使用的是没有 MCP 的聊天界面,请在会话开始时粘贴
https://docs.localpayment.com/llms.txt,向 AI 提供完整的文档概览,然后再提出问题。 - 纯文本文章:对于特定主题,请在任何文档 URL 后添加后缀
.md(例如https://docs.localpayment.com/docs/virtual-accounts-overview.md),并将内容直接粘贴到提示中。
身份验证和令牌管理
每次调用 Localpayment API 之前都需要进行身份验证。这些提示涵盖了令牌的整个生命周期。如果您是从零开始,进行首次测试付款指南将逐步引导您完成整个流程——令牌 → 付款方式发现 → 创建付款 → webhook → 状态检查——每个调用都有真实的 curl 示例。
🔌 Show me the complete authentication flow for the Localpayment API. How do I generate an access token (POST /api/token/), how long do the access and refresh tokens last, and how do I reuse the access token until it expires? Also explain the optional refresh endpoint (POST /api/token/refresh/) and how its token rotation works. Include curl examples for both calls and show me the correct way to store and use the token in subsequent requests using environment variables.
🔌 My Localpayment API requests are returning 401 Unauthorized. Walk me through diagnosing the issue: is my token expired, was it generated incorrectly, or is there something wrong with how I'm passing it in the Authorization header? Show me how to request a new token and retry the failed request. If the refresh endpoint returns 401 "Invalid or expired token", explain the possible causes (expired, already used, or invalidated by a newer token request) and what to do instead.
🔌 I'm building a long-running service that makes Localpayment API calls continuously. Show me the correct pattern for managing the token lifecycle: how to share a single token pair across all my processes and workers, how to request a new token when the access token expires or I get a 401 mid-operation, and how to avoid parallel token requests that invalidate earlier refresh tokens.
虚拟账户
首先需要进行身份验证。 每次调用 Localpayment API 都需要有效的 Bearer 令牌。在运行以下任何提示之前,请确保您的集成已处理令牌生成(
POST /api/token/),并在当前令牌过期时申请新令牌。详情请参阅身份验证指南。以下“完整流程”提示包括身份验证作为第一步。完整集成——Happy Path 流程
使用这些提示,构建从创建到对账的完整虚拟账户集成。- 阿根廷(CVU)
- 墨西哥(SPEI / TEF)
- 哥伦比亚(Bre-B)
- 巴西(Pix)
- 秘鲁(CCI)
创建虚拟账户:模拟支付(阶段):接收并解析 webhook:完整 Happy Path 流程——从头到尾:
Using the Localpayment API, help me create a CVU virtual account for an individual beneficiary in Argentina. Show me the full request with all required fields, a complete curl example, and the expected successful response. Also explain what the account number returned represents and how to share it with the payer.
I have an active CVU virtual account in Localpayment's Stage environment with externalId [YOUR_EXTERNAL_ID]. Show me how to simulate an incoming payment to this account using the simulate endpoint. Include the curl request and explain what webhook payload I should expect to receive.
I received the following webhook payload from Localpayment after a payment to a CVU virtual account in Argentina. Explain each field, identify which fields I should use to reconcile this payment with my internal records, and tell me what the beneficiary.bank.account.number field represents:
[PASTE YOUR WEBHOOK PAYLOAD HERE]
Walk me through the COMPLETE integration flow for CVU virtual accounts in Argentina using the Localpayment API. Cover ALL necessary steps:
1. Authentication: generate an access token (POST /api/token/), reuse it while it is valid, and request a new one when it expires or returns 401
2. (Optional) Discover available payment methods for Argentina (GET /api/resources/payment-methods)
3. Create a CVU virtual account (POST /api/virtual-account) for an individual beneficiary — show all required fields and the expected response
4. Verify the account is active: check status (GET /api/virtual-account/{externalId})
5. Share the CVU with the payer and explain what they need to do
6. Simulate an incoming payment in Stage (POST /api/simulate/va)
7. Receive and parse the webhook: identify the key reconciliation fields (especially beneficiary.bank.account.number and tracking object)
Include curl examples for each step. Use Stage environment. Use environment variables for all credentials.
创建虚拟账户:SPEI 与 TEF——了解它们的区别:完整 Happy Path 流程——从头到尾:
Using the Localpayment API, help me create a CLABE virtual account for Mexico (SPEI). Show me the full request with all required fields for a company beneficiary, a complete curl example, and the expected successful response.
Explain the difference between SPEI (payment method code 1630) and TEF (payment method code 1680) in the context of Localpayment virtual accounts in Mexico. When would I receive a webhook with each code? Are there differences in the webhook payload structure?
Walk me through the COMPLETE integration flow for SPEI virtual accounts in Mexico using the Localpayment API. Cover ALL necessary steps:
1. Authentication: generate an access token (POST /api/token/), reuse it while it is valid, and request a new one when it expires or returns 401
2. Create a CLABE virtual account for SPEI (POST /api/virtual-account) — show required fields for Mexico and the expected response
3. Verify the account is active (GET /api/virtual-account/{externalId})
4. Share the CLABE with the payer
5. Simulate an incoming SPEI payment in Stage (POST /api/simulate/va)
6. Receive and parse the webhook: explain paymentMethod.code 1630 (SPEI) vs 1680 (TEF), and the key reconciliation fields including tracking.id
Include curl examples. Use Stage environment. Use environment variables for all credentials.
创建虚拟账户:完整 Happy Path 流程——从头到尾:
Using the Localpayment API, help me create a Bre-B virtual account in Colombia. Show me the full request, required fields, and the expected response including the Bre-B key that will be assigned.
Walk me through the COMPLETE integration flow for Bre-B virtual accounts in Colombia using the Localpayment API. Cover ALL necessary steps:
1. Authentication: generate an access token (POST /api/token/)
2. Create a Bre-B virtual account (POST /api/virtual-account) — show required fields for Colombia and the Bre-B key returned in the response
3. Verify the account is active (GET /api/virtual-account/{externalId})
4. Share the Bre-B key with the payer
5. Simulate a payment in Stage (POST /api/simulate/va)
6. Receive and parse the webhook: explain why Bre-B always returns status 200 COMPLETED with no intermediate states, and identify the key reconciliation fields (tracking.id, beneficiary.bank.account.number)
Include curl examples. Use Stage environment.
创建虚拟账户:完整 Happy Path 流程——从头到尾:
Using the Localpayment API, help me create a Pix virtual account in Brazil for an individual beneficiary. Show me the full request with all required fields and the expected response including the Pix key (alias) returned.
Walk me through the COMPLETE integration flow for Pix virtual accounts in Brazil using the Localpayment API. Cover ALL necessary steps:
1. Authentication: generate an access token (POST /api/token/)
2. Create a Pix virtual account (POST /api/virtual-account) for an individual beneficiary — show required fields for Brazil and the Pix key (alias) returned in the response
3. Verify the account is active (GET /api/virtual-account/{externalId})
4. Share the Pix key with the payer and explain the different key types (random, email, phone)
5. Simulate an incoming Pix payment in Stage (POST /api/simulate/va)
6. Receive and parse the webhook: identify key reconciliation fields including beneficiary.bank.account.number and the alias fields
Include curl examples. Use Stage environment.
创建虚拟账户:完整 Happy Path 流程——从头到尾:
Using the Localpayment API, help me create a CCI virtual account in Peru for an individual beneficiary. Include the required document field (mandatory for Peru) and show a complete curl example with the expected response.
Walk me through the COMPLETE integration flow for CCI virtual accounts in Peru using the Localpayment API. Cover ALL necessary steps:
1. Authentication: generate an access token (POST /api/token/)
2. Create a CCI virtual account (POST /api/virtual-account) for an individual beneficiary in Peru — note that the document field is mandatory for Peru, include it in the example
3. Verify the account is active (GET /api/virtual-account/{externalId})
4. Share the CCI (20-digit account number) with the payer
5. Simulate an incoming payment in Stage (POST /api/simulate/va)
6. Receive and parse the webhook: explain the reconciliation flow and how to handle cases where certain Peruvian banks do not return the payer's full name
Include curl examples. Use Stage environment.
虚拟账户操作
🔌 I need to temporarily disable a virtual account in Localpayment and re-enable it later. Show me the API calls for both operations, the required parameters, and what status changes I should expect in the webhook.
🔌 I want to delete a virtual account in Localpayment. Explain the consequences (is it reversible?), the API call required, and what happens to future payments sent to that account after deletion.
🔌 Show me how to create a CVU alias for a virtual account in Argentina. Include the format rules, the API request, the asynchronous activation flow (INPROGRESS status), and how to verify that the alias is active.
🔌 I need to check the current status of a virtual account including its assigned aliases. Show me the Get Virtual Account Status endpoint, the full response structure, and how to interpret each status code.
按国家构建集成
开启新的国家一体化进程
🔌 I want to start accepting payments in [COUNTRY] using the Localpayment API. What payment methods are available there? Walk me through the recommended integration path, required beneficiary fields, currency, and any country-specific considerations I should be aware of.
🔌 I already have a Localpayment integration working for Mexico (SPEI). I need to add support for Colombia (Bre-B). What changes do I need to make to my existing integration? Are the request structures different? What are the key differences in the webhook payload?
卡
🔌 Help me implement a one-time card payment using the Localpayment API. Show me the full request structure, required fields, how to handle the response, and what webhook I should expect when the payment is confirmed.
🔌 I want to implement 3D Secure authentication for card payments in Localpayment. Explain the flow, the additional fields required in the request, and how to handle the redirect and the final webhook notification.
🔌 Show me how to implement card tokenization in Localpayment. I want to save a customer's card for future payments without storing the raw card data. Include the tokenization request, how to use the token in a subsequent payment, and any expiration considerations.
替代支付方式 (APM)
🔌 I want to implement Pix payments (not virtual accounts) in Brazil using the Localpayment APM endpoint. Show me the request structure, required fields, and the webhook flow when the payment is completed.
🔌 I want to implement PSE payments in Colombia using the Localpayment API. Explain the flow, required fields, and how the redirect to the bank portal works. Include the webhook payload for a successful payment.
调试错误代码
I received the following error response from the Localpayment API. Explain what it means, what caused it, and how to fix it:
[PASTE YOUR ERROR RESPONSE HERE]
🔌 What does error code [ERROR_CODE] mean in the Localpayment API? When does it occur, and what is the recommended fix?
🔌 I'm getting error 500 "External ID already used - Duplication" from the Localpayment API. Explain why this happens and the correct strategy for handling external IDs to avoid duplication in my integration.
🔌 I'm getting error 771 "Your Client Payin Settings have not been configured". What does this mean and what steps should I take to resolve it?
🔌 I'm getting error 776 "The alias is already in use" when trying to create a CVU alias in Argentina. Explain the alias uniqueness rule and how to choose a valid, unique alias.
🔌 I'm getting error 778 "The alias cannot be changed now; you must wait 24 hours after the last update." Explain the alias change restriction and what my options are.
🔌 I'm receiving status 101 OnHold on a payin. What does this status mean, when does it occur, and what action (if any) should I take?
Webhooks 和对账
Explain the complete webhook notification flow for Localpayment virtual account payments. What fields should I use to match an incoming webhook to a specific virtual account and transaction in my system?
I received the following webhook payload and I'm not sure how to reconcile it with my internal records. Which fields are the authoritative identifiers, and what does each key field mean?
[PASTE YOUR WEBHOOK PAYLOAD HERE]
🔌 What is the difference between externalId and internalId in Localpayment webhook payloads? Which one should I use for idempotency checks, and which one for support queries?
🔌 Explain the tracking object in Localpayment webhook payloads. What are tracking.id, tracking.reference, and tracking.concept? In which countries or payment methods is each field most useful for reconciliation?
🔌 My server is receiving duplicate webhook notifications from Localpayment. Explain Localpayment's retry mechanism and the correct way to implement idempotency in my webhook handler to avoid processing the same payment twice.
测试与质量保证
🔌 Generate a comprehensive test suite for my Localpayment virtual account integration in [COUNTRY]. Include test cases for: successful payment, insufficient funds, invalid beneficiary, duplicate external ID, webhook delivery failure, and account status transitions.
🔌 I want to validate that my Localpayment integration covers all required fields for [COUNTRY]. Review the API spec and tell me if my request payload is missing any required parameters or contains any invalid values:
[PASTE YOUR REQUEST PAYLOAD HERE]
🔌 What are the Stage environment limitations I should be aware of when testing my Localpayment integration? Are there features that only work in Production?
🔌 Generate a Postman collection for the main Localpayment virtual account endpoints: create, get status, enable/disable, delete, and simulate payment. Use Stage as the base URL and include example request bodies for Argentina.
使用 MCP 工具探索 API
这些提示旨在直接与 Localpayment 服务器中提供的 MCP 工具配合使用。当您想要以编程方式导航 API 而不是询问具体的集成问题时,请使用这些提示。 完整 API 映射:🔌 Using the Localpayment MCP tools, list all available API endpoints organized by product area. For each group, briefly explain what it does and give me the most important endpoint in that group. I want a complete map of the API.
🔌 Using search-endpoints, find all API operations related to [TOPIC — e.g. "refunds", "subscriptions", "FX", "webhooks"]. For each result, show me the HTTP method, path, and a one-line description.
🔌 Search the Localpayment documentation for "[TOPIC]" and fetch the most relevant article. Read the full content and summarize: what the feature does, the key parameters, and any important caveats or country-specific notes.
🔌 Use get-endpoint to retrieve the full schema for [ENDPOINT 1] and [ENDPOINT 2]. Compare their request structures, required fields, and response formats. Highlight the key differences between the two.
🔌 I'm about to integrate [FEATURE] for [COUNTRY] using the Localpayment API. Before I start coding, use the MCP tools to: 1) find the relevant endpoints, 2) identify all required fields and validation rules, 3) check for any country-specific requirements or restrictions, and 4) list what webhook events I should expect. Give me a pre-integration checklist.
🔌 Before I send this API request to Localpayment, use get-endpoint to read the live schema and validate my payload. Tell me if any required fields are missing, if any values are in the wrong format, and if there are any restrictions I might be violating:
[PASTE YOUR REQUEST PAYLOAD HERE]

