{"content":[{"text":"total 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Sep 29 08:18 ..\ndrwxr-xr-x 8 root root 4096 Sep 24 20:05 .git\n-rw-r--r-- 1 root root  408 Sep 18 08:00 .gitignore\n","type":"text"}]}

{"content":[{"text":"# Keep generated and vendored files out of source diffs.\n\n# Logs / OS cruft\n*.log\n.DS_Store\n\n# JavaScript / TypeScript\nnode_modules/\n.next/\ndist/\nbuild/\ncoverage/\n\n# Python\n.venv/\nvenv/\n__pycache__/\n*.py[cod]\n.pytest_cache/\n*.egg-info/\n\n# Rust\ntarget/\n\n# Go / PHP / Ruby vendored deps\nvendor/\n.bundle/\n\n# Java / Kotlin / Scala\n.gradle/\n\n# .NET\nbin/\nobj/\n\n# Elixir\n_build/\ndeps/\n\n# Dart / Flutter\n.dart_tool/\nv22.23.2\n10.9.8\nPython 3.12.3\n","type":"text"}]}

{"content":[{"text":"npm error 404  'dlocal-node@*' is not in this registry.\nnpm error 404\nnpm error 404 Note that you can also install from a\nnpm error 404 tarball, folder, http url, or git url.\nnpm error A complete log of this run can be found in: /sandbox/.npm/_logs/2026-09-29T08_18_25_862Z-debug-0.log\n---\n404\n","type":"text"}]}

cd /tmp && timeout 30 curl -sS "https://registry.npmjs.org/-/v1/search?text=dlocal&size=20" | python3 -c "import json,sys; d=json.load(sys.stdin); [print(o['package']['name'], o['package']['version'], o['package'].get('description','')[:90], o['package'].get('date','')[:10]) for o in d['objects']]"

{"content":[{"text":"@codespar/mcp-dlocal 0.2.2 MCP server for dLocal — LatAm cross-border payments, payouts, refunds across 15+ countries 2026-06-22\ndlocaljs 0.0.2-a A Node.js library for interacting with the DLocal API. 2024-04-26\nbnext-dl-data-collector-cordova-plugin 0.0.2 dLocal Data Collector SDK ionic plugin 2022-08-09\n@dlocal-int/dashboard-app 99.49.53 # To use this template: 2024-06-18\n@dlocal-int/react-ui-components 99.49.53 # To use this template: 2024-06-18\n@codespar/mcp-rapyd 0.2.2 MCP server for Rapyd — global collect + disburse across 100+ countries, including cash pic 2026-06-22\ndlocal-pcap 1.0.0  2024-06-18\ndlocal-exceptions 1.0.0  2024-06-19\ndlocal-logger 1.0.0  2024-06-19\ndlocal-ui-components 1.0.0  2024-06-19\ndlocal-rest-connector 1.0.0  2024-06-19\ndlocal-direct-client-deployer 1.0.0  2024-06-19\ndlocal-net-events 1.0.0  2024-06-19\n@yuno-payments/agent-toolkit 0.1.2 > AI framework integrations for the Yuno payment orchestrator 2026-03-19\ndlocal-swagger-ui 1.0.0  2024-06-19\ngulp-dlocal-deploy 1.0.0  2024-06-18\n@usefin/plugin-payments 0.1.0 Payments & Payment Processing (non-Stripe) provider plugins for fin CLI 2026-03-02\n@autorest/azure-functions-java 0.0.2-Preview The Java extension for classic generators in AutoRest. 2020-09-01\nheh-storage 1.0.0  2018-05-22\n","type":"text"}]}

timeout 30 curl -sS "https://pypi.org/search/?q=dlocal" -o /dev/null -w "%{http_code}\n"; timeout 30 curl -sS "https://pypi.org/pypi/dlocal/json" | head -c 400; echo; timeout 30 curl -sS "https://pypi.org/pypi/dlocal-api/json" | head -c 300

timeout 30 curl -sS "https://api.github.com/orgs/dlocal/repos?per_page=100&sort=updated" | python3 -c "import json,sys;d=json.load(sys.stdin);[print(r['name'], r['language'], r['stargazers_count'], r['pushed_at'][:10], (r['description'] or '')[:80]) for r in d]" 2>&1 | head -40

{"content":[{"text":"mobile-checkout-sdk-ios Swift 2 2024-04-05 dLocal Mobile Checkout SDK for iOS\ndlocal-biometrics-android-sdk-demo None 0 2026-06-10 \ndlocal-direct-js-native-integration Kotlin 0 2025-09-04 \nStarter-Code-Examples JavaScript 0 2025-07-25 \ndlocal-direct-ios-sdk Swift 3 2024-06-28 dLocal Direct SDK for iOS\ndlocal-direct-android-sdk HTML 0 2024-06-24 dLocal Direct SDK for Android\nsmart-fields-examples HTML 8 2021-06-11 SmartFields examples\nmobile-checkout-sdk-android HTML 0 2023-10-27 dLocal Mobile Checkout SDK for Android\nweb-drop-in-sdk-ios Ruby 0 2023-01-03 dlocal-public\nweb-drop-in-sdk-android Kotlin 0 2023-01-20 dlocal-public\ndlocal-data-collector-capacitor-plugin TypeScript 0 2023-01-03 dlocal-public\ndlocal-data-collector-cordova-plugin Java 0 2023-01-03 dlocal-public\ndata-collector-sdk-ios Swift 0 2023-01-18 dlocal-public\ndata-collector-sdk-android Kotlin 0 2023-01-17 dlocal-public\nremoteuy JavaScript 2 2022-08-17 Listado de empresas uruguayas que promueven el trabajo remoto y distribuído\n","type":"text"}]}

timeout 30 curl -sS -o /dev/null -w "sandbox:%{http_code}\n" https://sandbox.dlocal.com/ ; timeout 30 curl -sS -o /dev/null -w "api:%{http_code}\n" https://api.dlocal.com/ ; timeout 30 curl -sS -o /dev/null -w "docs:%{http_code}\n" https://docs.dlocal.com/ ; timeout 30 curl -sS -o /dev/null -w "dev:%{http_code}\n" https://developers.dlocal.com/

{"content":[{"text":"sandbox:200\napi:200\ndocs:200\ncurl: (6) Could not resolve host: developers.dlocal.com\ndev:000\n\n\nCommand exited with code 6","type":"text"}],"details":{}}

cd /tmp && timeout 40 curl -sSL https://docs.dlocal.com/ -o dlocal_docs.html && wc -c dlocal_docs.html && python3 - <<'EOF'
import re
h=open('/tmp/dlocal_docs.html',encoding='utf-8',errors='ignore').read()
links=set(re.findall(r'href="([^"]+)"',h))
for l in sorted(links):
    if 'dlocal' in l or l.startswith('/'): print(l)
EOF

{"content":[{"text":"449863 dlocal_docs.html\n/\n/docs\n/docs/accounts-structure\n/docs/coverage-payins\n/docs/fraud-prevention-overview\n/docs/get-api-credentials\n/docs/integrate-payouts-v3\n/docs/overview-payins#connections-to-payins\n/docs/overview-payouts-v3\n/docs/payment-method\n/docs/pci-compliance\n/docs/platforms-overview\n/login?redirect_uri=/\n/reference\n/reference/country-reference\n/reference/payins-security\n/reference/security-payouts-v3\n/search\nhttps://dlocal.statuspage.io/\nhttps://docs.dlocal.com/\nhttps://docs.dlocal.com/docs\nhttps://docs.dlocal.com/docs/get-started\nhttps://docs.dlocal.com/docs/requirements-per-industry\nhttps://docs.dlocal.com/llms.txt\nhttps://docs.dlocal.com/reference\nhttps://docs.dlocal.com/reference/api\nhttps://docs.dlocal.com/reference/environments-v2-platforms\nhttps://www.dlocal.com/contact-sales/\nhttps://www.dlocal.com/legal/brazil/\nhttps://www.dlocal.com/legal/privacy-hub/\nhttps://www.dlocal.com/legal/regulatory-disclosure/\nhttps://www.dlocal.com/legal/terms-and-conditions/\nhttps://www.dlocal.com/our-solution/dlocal-defense-suite-for-fraud-management/\nhttps://www.linkedin.com/company/dlocal\nhttps://www.postman.com/dlocal-dev/workspace/dlocal/overview\n","type":"text"}]}

timeout 30 curl -sS "https://api.github.com/repos/dlocal/Starter-Code-Examples/git/trees/HEAD?recursive=1" | python3 -c "import json,sys;d=json.load(sys.stdin);[print(t['path']) for t in d['tree']]" 2>&1 | head -60

{"content":[{"text":".gitignore\nREADME.md\nSignatures\nSignatures/C# Payins\nSignatures/C# Payins/C# Payins.sln\nSignatures/C# Payins/C# Payins\nSignatures/C# Payins/C# Payins/C# Payins.csproj\nSignatures/C# Payins/C# Payins/C# Payins.sln\nSignatures/C# Payins/C# Payins/Program.cs\nSignatures/C# Payins/C# Payins/appsettings.Development.json\nSignatures/C# Payins/C# Payins/appsettings.json\nSignatures/C# Payins/README.md\nSignatures/C# Payouts\nSignatures/C# Payouts/C# Payouts.sln\nSignatures/C# Payouts/PayoutsC#\nSignatures/C# Payouts/PayoutsC#/PayoutsC#.csproj\nSignatures/C# Payouts/PayoutsC#/Program.cs\nSignatures/C# Payouts/PayoutsC#/appsettings.Development.json\nSignatures/C# Payouts/PayoutsC#/appsettings.json\nSignatures/C# Payouts/README.md\nSignatures/Go Payouts Payins\nSignatures/Go Payouts Payins/README.md\nSignatures/Go Payouts Payins/go.mod\nSignatures/Go Payouts Payins/go.sum\nSignatures/Go Payouts Payins/payins.go\nSignatures/Go Payouts Payins/payouts.go\nSignatures/Java Payins\nSignatures/Java Payins/pom.xml\nSignatures/Java Payins/src\nSignatures/Java Payins/src/main\nSignatures/Java Payins/src/main/java\nSignatures/Java Payins/src/main/java/com\nSignatures/Java Payins/src/main/java/com/example\nSignatures/Java Payins/src/main/java/com/example/PayinsRequest.java\nSignatures/Java Payouts\nSignatures/Java Payouts/pom.xml\nSignatures/Java Payouts/src\nSignatures/Java Payouts/src/main\nSignatures/Java Payouts/src/main/java\nSignatures/Java Payouts/src/main/java/com\nSignatures/Java Payouts/src/main/java/com/example\nSignatures/Java Payouts/src/main/java/com/example/GetPayoutRequest.java\nSignatures/Java Payouts/src/main/java/com/example/PayoutRequest.java\nSignatures/Javascript Payouts Payins\nSignatures/Javascript Payouts Payins/.gitignore\nSignatures/Javascript Payouts Payins/README.md\nSignatures/Javascript Payouts Payins/index.js\nSignatures/Javascript Payouts Payins/misc\nSignatures/Javascript Payouts Payins/misc/notifications.csv\nSignatures/Javascript Payouts Payins/package.json\nSignatures/Javascript Payouts Payins/routes\nSignatures/Javascript Payouts Payins/routes/notifications.js\nSignatures/Javascript Payouts Payins/routes/payins-certificate-auth-get-payments.js\nSignatures/Javascript Payouts Payins/routes/payins-certificate-auth.js\nSignatures/Javascript Payouts Payins/routes/payins.js\nSignatures/Javascript Payouts Payins/routes/payouts.js\nSignatures/Python Payouts Payins\nSignatures/Python Payouts Payins/README.md\nSignatures/Python Payouts Payins/payins_payment_request.py\nSignatures/Python Payouts Payins/payouts_payment_request.py\n","type":"text"}]}

{"content":[{"text":"358 llms.txt\n  - [Costa Rica](https://docs.dlocal.com/docs/costa-rica.md): Learn about the dLocal supported payment methods in Costa Rica.\n- [Overview](https://docs.dlocal.com/docs/overview-smart-fields.md): Learn how to build checkout forms on your site using customizable UI components.\n- [Set up guide](https://docs.dlocal.com/docs/set-up-smart-fields.md): Discover everything you need to know about configuring Smart Fields.\n- [Examples](https://docs.dlocal.com/docs/examples-smart-fields.md): Explore how to maximize Smart Fields usage with these ready-to-use examples.\n- [dLocal Direct](https://docs.dlocal.com/docs/using-dlocal-direct.md): Tokenize cards securely using dLocal Direct.\n  - [Native payment flow](https://docs.dlocal.com/docs/native-payment-dlocal-direct.md): Integrate dLocal Direct in native apps using a secure WebView for card tokenization.\n- [Checkout redirect](https://docs.dlocal.com/docs/integrate-checkout.md): Easily activate payments with dLocal’s Checkout solution.\n    - [Network tokens](https://docs.dlocal.com/docs/card-network-tokens.md): Learn how to handle network token payments.\n    - [Google Pay™](https://docs.dlocal.com/docs/google-paytm.md): Accept Google Pay payments through dLocal by collecting a Google Pay token and submitting it in a standard card payment request.\n- [Brazil / SmartPix](https://docs.dlocal.com/docs/brazil-smartpix.md): Learn how to integrate SmartPix for seamless recurring on demand payments.\n  - [Authorization checkout managed by dLocal](https://docs.dlocal.com/docs/redirect-smartpix.md): Enroll users for SmartPix payments through a simple redirect-based flow.\n  - [Recurring payments](https://docs.dlocal.com/docs/recurring-payments-smartpix.md): Learn how to enroll users for SmartPix payments.\n  - [Cancel token](https://docs.dlocal.com/docs/cancel-token-smartpix.md): Understand how the token cancellation process works.\n  - [Payment flow in native apps](https://docs.dlocal.com/docs/native-payment-smartpix.md): Enable SmartPix payments in your native Android or iOS app using a WebView.\n  - [Payment flow in web embeds](https://docs.dlocal.com/docs/web-payment-smartpix.md): Add the SmartPix payment flow to your web app with an iframe-based flow.\n- [India / Network Tokenization](https://docs.dlocal.com/docs/india-network-tokenization.md): Discover how to implement RBI-compliant card tokenization for secure transactions in India.\n  - [Costa Rica](https://docs.dlocal.com/docs/costa-rica-payouts-v3.md): Learn everything you need to know to make payouts in Costa Rica with dLocal.\n- [Cancel wallet token](https://docs.dlocal.com/reference/cancel-wallet-token.md): This service allows merchants to cancel an active token.\n## API Reference: Smart Fields\n- [Update account settings](https://docs.dlocal.com/reference/update-settings-v2-platforms.md): This service is responsible for updating account settings like pricing level and settlement period.\n","type":"text"}]}

cd /tmp && for f in "Signatures/Javascript Payouts Payins/index.js" "Signatures/Javascript Payouts Payins/routes/payins.js" "Signatures/Javascript Payouts Payins/README.md" "Signatures/Javascript Payouts Payins/package.json"; do echo "=== $f"; timeout 30 curl -sS "https://raw.githubusercontent.com/dlocal/Starter-Code-Examples/HEAD/$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1]))" "$f")"; done

{"content":[{"text":"=== Signatures/Javascript Payouts Payins/index.js\n// Import the Express framework\r\nconst express = require('express');\r\n\r\n// Import custom route modules\r\nconst payoutsRoute = require('./routes/payouts');\r\nconst payinsRoute = require('./routes/payins');\r\nconst payinsCertificateAuthRoute = require('./routes/payins-certificate-auth');\r\nconst payinsCertificateAuthRouteGetPaymentMethods = require('./routes/payins-certificate-auth-get-payments');\r\nconst notificationsRoute = require('./routes/notifications');\r\n\r\n// Create an instance of the Express application\r\nconst app = express();\r\nconst PORT = 3000; // Set the port for the server (you can use any port you prefer)\r\n\r\n// Middleware to parse JSON in request bodies\r\napp.use(express.json());\r\n\r\n// Use the defined routes for specific functionalities\r\n\r\n// Route for managing payouts\r\napp.use('/payouts', payoutsRoute);\r\n\r\n// Route for managing pay-ins\r\napp.use('/payins', payinsRoute);\r\n\r\n// Route for certificate-authenticated pay-ins with payment method retrieval\r\napp.use('/payins-certificate-auth-get-payments', payinsCertificateAuthRouteGetPaymentMethods);\r\n\r\n// Route for certificate-authenticated pay-ins\r\napp.use('/payins-certificate-auth', payinsCertificateAuthRoute);\r\n\r\n// Route for handling notifications\r\napp.use('/notifications', notificationsRoute);\r\n\r\n// Start the server and listen on the specified port\r\napp.listen(PORT, () => {\r\n  console.log(`Server is running on http://localhost:${PORT}`);\r\n});\r\n=== Signatures/Javascript Payouts Payins/routes/payins.js\nconst express = require('express');\r\nconst axios = require('axios');\r\nconst crypto = require('crypto');\r\n\r\nconst router = express.Router();\r\n\r\n// Function to generate HMAC SHA256 signature\r\nfunction generateHmacSha256Signature(payload, secretKey) {\r\n  const hmac = crypto.createHmac('sha256', secretKey);\r\n  hmac.update(payload);\r\n  return hmac.digest('hex');\r\n}\r\n\r\nrouter.post('/', async (req, res) => {\r\n  const apiURL = 'https://sandbox.dlocal.com/secure_payments';\r\n  const timestamp = new Date().toISOString();\r\n  const login = 'x';\r\n  const transKey = 'x';\r\n  const secretKey = 'x';\r\n  // Replace this with your actual request payload\r\n  const requestPayload = req.body\r\n\r\n  const body = JSON.stringify(requestPayload);\r\n  const concatenatedData = `${login}${timestamp}${body}`;\r\n  const keyBytes = Buffer.from(secretKey, 'utf-8');\r\n\r\n  const hashBytes = generateHmacSha256Signature(concatenatedData, keyBytes);\r\n\r\n  const headers = {\r\n    'X-Date': timestamp,\r\n    'X-Login': login,\r\n    'X-Trans-Key': transKey,\r\n    Authorization: `V2-HMAC-SHA256, Signature: ${hashBytes}`,\r\n  };\r\n\r\n  try {\r\n    const response = await axios.post(apiURL, requestPayload, { headers });\r\n    console.log(`Response: ${JSON.stringify(response.data)}`);\r\n    console.log(`Header: ${JSON.stringify(response.headers)}`);\r\n    res.json({ message: 'Payment request successful', response: response.data });\r\n  } catch (error) {\r\n    console.error(`Payment request failed. Headers: ${error.response.headers}`);\r\n    console.error(`Payment request failed. Message: ${error.response.data.message}`);\r\n    res.status(500).json({ error: `Payment request failed. Error: ${error.response.data.message}` });\r\n  }\r\n});\r\n\r\nmodule.exports = router;\r\n=== Signatures/Javascript Payouts Payins/README.md\n��#� �N�o�d�e�.�j�s� �P�a�y�m�e�n�t�s� �P�r�o�j�e�c�t�\r�\n�\r�\n�T�h�i�s� �N�o�d�e�.�j�s� �p�r�o�j�e�c�t� �i�s� �a� �s�i�m�p�l�e� �i�m�p�l�e�m�e�n�t�a�t�i�o�n� �f�o�r� �h�a�n�d�l�i�n�g� �p�a�y�o�u�t�s�,� �p�a�y�i�n�s�,� �n�o�t�i�f�i�c�a�t�i�o�n�s�,� �a�n�d� �c�a�l�l�b�a�c�k�s� �u�s�i�n�g� �t�h�e� �d�L�o�c�a�l� �A�P�I�.�\r�\n�\r�\n�#�#� �F�e�a�t�u�r�e�s�\r�\n�\r�\n�-� �*�*�P�a�y�o�u�t�s�*�*�:� �H�a�n�d�l�e� �c�a�s�h�o�u�t� �r�e�q�u�e�s�t�s� �u�s�i�n�g� �t�h�e� �d�L�o�c�a�l� �A�P�I�.�\r�\n�-� �*�*�P�a�y�i�n�s�*�*�:� �P�r�o�c�e�s�s� �s�e�c�u�r�e� �p�a�y�m�e�n�t�s� �u�s�i�n�g� �t�h�e� �d�L�o�c�a�l� �s�e�c�u�r�e� �p�a�y�m�e�n�t�s� �A�P�I�.�\r�\n�-� �*�*�A�u�t�o�m�a�t�i�c� �S�i�g�n�a�t�u�r�e� �C�a�l�c�u�l�a�t�i�o�n�*�*�:� �T�h�e� �p�r�o�j�e�c�t� �a�u�t�o�m�a�t�i�c�a�l�l�y� �c�a�l�c�u�l�a�t�e�s� �s�i�g�n�a�t�u�r�e�s� �f�o�r� �p�a�y�i�n�s� �a�n�d� �p�a�y�o�u�t�s� �b�a�s�e�d� �o�n� �t�h�e� �p�r�o�v�i�d�e�d� �r�e�q�u�e�s�t� �p�a�y�l�o�a�d�s�.�\r�\n� � � � �-� �*�*�A�u�t�o�m�a�t�i�c� �S�i�g�n�a�t�u�r�e� �C�a�l�c�u�l�a�t�i�o�n� �u�s�i�n�g� �a� �c�e�r�t�i�f�i�c�a�t�e�*�*�:� �T�h�e� �p�r�o�j�e�c�t� �a�u�t�o�m�a�t�i�c�a�l�l�y� �c�a�l�c�u�l�a�t�e�s� �s�i�g�n�a�t�u�r�e�s� �f�o�r� �p�a�y�i�n�s� �a�n�d� �p�a�y�o�u�t�s� �b�a�s�e�d� �o�n� �t�h�e� �p�r�o�v�i�d�e�d� �r�e�q�u�e�s�t� �p�a�y�l�o�a�d�s� �b�u�t� �n�o�w� �u�s�i�n�g� �a� �c�e�r�t�i�f�i�c�a�t�e�.�\r�\n�-� �*�*�N�o�t�i�f�i�c�a�t�i�o�n�s�*�*�:� �R�e�c�e�i�v�e� �a�n�d� �s�t�o�r�e� �n�o�t�i�f�i�c�a�t�i�o�n�s� �i�n� �a� �C�S�V� �f�i�l�e�.�\r�\n�\r�\n�#�#� �C�o�n�f�i�g�u�r�a�t�i�o�n�\r�\n�\r�\n�1�.� �*�*�I�n�s�t�a�l�l� �D�e�p�e�n�d�e�n�c�i�e�s�:�*�*�\r�\n� � � �`�`�`�b�a�s�h�\r�\n� � � �n�p�m� �i�n�s�t�a�l�l�\r�\n� � � �`�`�`�\r�\n�\r�\n�2�.� �*�*�C�o�n�f�i�g�u�r�e� �A�P�I� �C�r�e�d�e�n�t�i�a�l�s�:�*�*�\r�\n�\r�\n�*� �O�p�e�n� �t�h�e� �a�p�p�r�o�p�r�i�a�t�e� �r�o�u�t�e� �f�i�l�e�s� �(�*�*�p�a�y�o�u�t�s�.�j�s�*�*�,� �*�*�p�a�y�i�n�s�.�j�s�*�*�,� �*�*�n�o�t�i�f�i�c�a�t�i�o�n�s�.�j�s�*�*�)� �i�n� �t�h�e� �r�o�u�t�e�s� �d�i�r�e�c�t�o�r�y�.�\r�\n�*� �U�p�d�a�t�e� �t�h�e� �*�*�l�o�g�i�n�*�*�,� �*�*�t�r�a�n�s�K�e�y�*�*�,� �a�n�d� �*�*�s�e�c�r�e�t�K�e�y�*�*� �v�a�r�i�a�b�l�e�s� �w�i�t�h� �y�o�u�r� �d�L�o�c�a�l� �A�P�I� �c�r�e�d�e�n�t�i�a�l�s�.�\r�\n�3�.� �*�*�R�u�n� �t�h�e� �A�p�p�l�i�c�a�t�i�o�n�:�*�*�\r�\n�\r�\n� � � �`�`�`�b�a�s�h�\r�\n� � � �n�p�m� �s�t�a�r�t�\r�\n� � � �`�`�`�\r�\n�\r�\n�3�.� �*�*�E�n�d�p�o�i�n�t�s�:�*�*�\r�\n�\r�\n�*� �P�a�y�o�u�t�s�:� �*�*�P�O�S�T� �/�p�a�y�o�u�t�s�*�*�\r�\n� � �*� �E�x�a�m�p�l�e� �B�o�d�y�:�\r�\n�\r�\n� � � � �`�`�`�j�s�o�n�\r�\n� � � � �{�\r�\n� � � � � � � � �\"�e�x�t�e�r�n�a�l�_�i�d�\"�:� �\"�#�R�A�N�D�O�M�A�L�P�H�A�N�U�M�E�R�I�C�:�9�\"�,�\r�\n� � � � � � � � �\"�d�o�c�u�m�e�n�t�_�i�d�\"�:� �\"�7�6�9�2�3�7�8�3�6�\"�,�\r�\n� � � � � � � � �\"�d�o�c�u�m�e�n�t�_�t�y�p�e�\"�:� �\"�R�U�T�\"�,�\r�\n� � � � � � � � �\"�b�e�n�e�f�i�c�i�a�r�y�_�n�a�m�e�\"�:� �\"�D�l�o�c�a�l� �C�h�i�l�e�\"�,�\r�\n� � � � � � � � �\"�b�e�n�e�f�i�c�i�a�r�y�_�l�a�s�t�n�a�m�e�\"�:� �\"�S�P�A�\"�,�\r�\n� � � � � � � � �\"�c�o�u�n�t�r�y�\"�:� �\"�C�L�\"�,�\r�\n� � � � � � � � �\"�b�a�n�k�_�c�o�d�e�\"�:� �\"�3�9�\"�,�\r�\n� � � � � � � � �\"�b�a�n�k�_�a�c�c�o�u�n�t�\"�:� �\"�0�2�1�3�8�8�0�9�6�2�\"�,�\r�\n� � � � � � � � �\"�a�c�c�o�u�n�t�_�t�y�p�e�\"�:� �\"�C�\"�,�\r�\n� � � � � � � � �\"�a�m�o�u�n�t�\"�:� �\"�1�0�0�\"�,�\r�\n� � � � � � � � �\"�c�u�r�r�e�n�c�y�\"�:� �\"�C�L�P�\"�,�\r�\n� � � � � � � � �\"�t�y�p�e�\"�:� �\"�j�s�o�n�\"�,�\r�\n� � � � � � � � �\"�p�u�r�p�o�s�e�\"�:� �\"�E�P�F�A�M�T�\"�\r�\n� � � � �}�\r�\n� � � � �`�`�`�\r�\n�\r�\n�*� �P�a�y�i�n�s�:� �*�*�P�O�S�T� �/�p�a�y�i�n�s�*�*�\r�\n� � � � �*� �E�x�a�m�p�l�e� �B�o�d�y�:�\r�\n� � � � �`�`�`�j�s�o�n�\r�\n� � � � �{�\r�\n� � � � � � � � �\"�a�m�o�u�n�t�\"�:� �\"�1�0�0�\"�,�\r�\n� � � � � � � � �\"�c�u�r�r�e�n�c�y�\"�:� �\"�U�S�D�\"�,�\r�\n� � � � � � � � �\"�c�o�u�n�t�r�y�\"�:� �\"�B�R�\"�,�\r�\n� � � � � � � � �\"�p�a�y�m�e�n�t�_�m�e�t�h�o�d�_�i�d�\"�:� �\"�P�Q�\"�,�\r�\n� � � � � � � � �\"�p�a�y�m�e�n�t�_�m�e�t�h�o�d�_�f�l�o�w�\"�:� �\"�R�E�D�I�R�E�C�T�\"�,�\r�\n� � � � � � � � �\"�p�a�y�e�r�\"�:� �{�\r�\n� � � � � � � � � � � � �\"�n�a�m�e�\"�:� �\"�T�h�i�a�g�o� �G�a�b�r�i�e�l�\"�,�\r�\n� � � � � � � � � � � � �\"�e�m�a�i�l�\"�:� �\"�t�h�i�a�g�o�@�e�x�a�m�p�l�e�.�c�o�m�\"�,�\r�\n� � � � � � � � � � � � �\"�d�o�c�u�m�e�n�t�\"�:� �\"�5�3�0�3�3�3�1�5�5�5�0�\"�,�\r�\n� � � � � � � � � � � � �\"�u�s�e�r�_�r�e�f�e�r�e�n�c�e�\"�:� �\"�1�2�3�4�5�\"�,�\r�\n� � � � � � � � � � � � �\"�a�d�d�r�e�s�s�\"�:� �{�\r�\n� � � � � � � � � � � � � � � � �\"�s�t�a�t�e�\"�:� �\"�R�i�o� �d�e� �J�a�n�e�i�r�o�\"�,�\r�\n� � � � � � � � � � � � � � � � �\"�c�i�t�y�\"�:� �\"�V�o�l�t�a� �R�e�d�o�n�d�a�\"�,�\r�\n� � � � � � � � � � � � � � � � �\"�z�i�p�_�c�o�d�e�\"�:� �\"�2�7�2�7�5�-�5�9�5�\"�,�\r�\n� � � � � � � � � � � � � � � � �\"�s�t�r�e�e�t�\"�:� �\"�S�e�r�v�i�d�a�o� �B�-�1�\"�,�\r�\n� � � � � � � � � � � � � � � � �\"�n�u�m�b�e�r�\"�:� �\"�1�1�0�6�\"�\r�\n� � � � � � � � � � � � �}�,�\r�\n� � � � � � � � � � � � �\"�i�p�\"�:� �\"�2�0�0�1�:�0�d�b�8�:�0�0�0�0�:�0�0�0�0�:�0�0�0�0�:�f�f�0�0�:�0�0�4�2�:�8�3�2�9�\"�,�\r�\n� � � � � � � � � � � � �\"�d�e�v�i�c�e�_�i�d�\"�:� �\"�2�f�g�3�d�4�g�f�2�3�4�\"�\r�\n� � � � � � � � �}�,�\r�\n� � � � � � � � �\"�o�r�d�e�r�_�i�d�\"�:� �\"�1�4�1�2�4�\"�,�\r�\n� � � � � � � � �\"�n�o�t�i�f�i�c�a�t�i�o�n�_�u�r�l�\"�:� �\"�h�t�t�p�s�:�/�/�f�0�c�f�-�1�7�9�-�4�8�-�1�1�6�-�2�0�0�.�n�g�r�o�k�-�f�r�e�e�.�a�p�p�/�n�o�t�i�f�i�c�a�t�i�o�n�s�\"�\r�\n� � � � �}�\r�\n� � � � �`�`�`�\r�\n�#�#� �A�d�d�i�t�i�o�n�a�l� �N�o�t�e�s�\r�\n�*� �E�n�s�u�r�e� �N�o�d�e�.�j�s� �a�n�d� �n�p�m� �a�r�e� �i�n�s�t�a�l�l�e�d� �o�n� �y�o�u�r� �m�a�c�h�i�n�e�.�\r�\n�*� �F�o�r� �t�e�s�t�i�n�g� �p�u�r�p�o�s�e�s�,� �u�s�e� �t�h�e� �d�L�o�c�a�l� �s�a�n�d�b�o�x� �e�n�v�i�r�o�n�m�e�n�t�.�\r�\n�*� �C�u�s�t�o�m�i�z�e� �t�h�e� �n�o�t�i�f�i�c�a�t�i�o�n� �l�o�g�i�c� �i�n� �*�*�n�o�t�i�f�i�c�a�t�i�o�n�s�.�j�s�*�*�.�\r�\n�*� �T�h�e� �C�S�V� �f�i�l�e� �(�*�*�n�o�t�i�f�i�c�a�t�i�o�n�s�.�c�s�v�*�*�)� �w�i�l�l� �b�e� �c�r�e�a�t�e�d� �i�n� �t�h�e� �p�r�o�j�e�c�t� �d�i�r�e�c�t�o�r�y�.�\r�\n�\r�\n�#�#� �D�e�p�e�n�d�e�n�c�i�e�s�\r�\n�*� �[�E�x�p�r�e�s�s�]�(�h�t�t�p�s�:�/�/�e�x�p�r�e�s�s�j�s�.�c�o�m�/�)�:� �W�e�b� �f�r�a�m�e�w�o�r�k� �f�o�r� �N�o�d�e�.�j�s�.�\r�\n�*� �[�A�x�i�o�s�]�(�h�t�t�p�s�:�/�/�a�x�i�o�s�-�h�t�t�p�.�c�o�m�/�)�:� �H�T�T�P� �c�l�i�e�n�t� �f�o�r� �m�a�k�i�n�g� �r�e�q�u�e�s�t�s�.�\r�\n�*� �[�c�r�y�p�t�o�]�(�h�t�t�p�s�:�/�/�n�o�d�e�j�s�.�o�r�g�/�a�p�i�/�c�r�y�p�t�o�.�h�t�m�l�)�:� �N�o�d�e�.�j�s� �c�r�y�p�t�o� �m�o�d�u�l�e� �f�o�r� �H�M�A�C� �g�e�n�e�r�a�t�i�o�n�.�\r�\n�*� �[�c�s�v�-�w�r�i�t�e�r�]�(�h�t�t�p�s�:�/�/�w�w�w�.�n�p�m�j�s�.�c�o�m�/�p�a�c�k�a�g�e�/�c�s�v�-�w�r�i�t�e�r�)�:� �C�S�V� �w�r�i�t�i�n�g� �l�i�b�r�a�r�y�.�\r�\n�\r�\n�#�#� �L�i�c�e�n�s�e�\r�\n�T�h�i�s� �p�r�o�j�e�c�t� �i�s� �l�i�c�e�n�s�e�d� �u�n�d�e�r� �t�h�e� �M�I�T� �L�i�c�e�n�s�e�.�=== Signatures/Javascript Payouts Payins/package.json\n{\n  \"name\": \"javascript-payouts-payins\",\n  \"version\": \"1.0.0\",\n  \"description\": \"\",\n  \"main\": \"index.js\",\n  \"scripts\": {\n    \"start\": \"nodemon index.js\",\n    \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\"\n  },\n  \"keywords\": [],\n  \"author\": \"\",\n  \"license\": \"ISC\",\n  \"dependencies\": {\n    \"axios\": \"^1.6.2\",\n    \"body-parser\": \"^1.20.2\",\n    \"crypto\": \"^1.0.1\",\n    \"csv-writer\": \"^1.6.0\",\n    \"express\": \"^4.18.2\"\n  }\n}\n","type":"text"}]}

cd /tmp && for p in docs/integrate-checkout docs/get-api-credentials reference/payins-security; do echo "############ $p"; timeout 40 curl -sSL "https://docs.dlocal.com/$p.md" -o "$(basename $p).md" -w "%{http_code} "; wc -c "$(basename $p).md"; done

{"content":[{"text":"############ docs/integrate-checkout\n200 14624 integrate-checkout.md\n############ docs/get-api-credentials\n200 3129 get-api-credentials.md\n############ reference/payins-security\n200 11407 payins-security.md\n","type":"text"}]}

{"content":[{"text":"  - [Costa Rica](https://docs.dlocal.com/docs/costa-rica.md): Learn about the dLocal supported payment methods in Costa Rica.\n  - [Costa Rica](https://docs.dlocal.com/docs/costa-rica-payouts-v3.md): Learn everything you need to know to make payouts in Costa Rica with dLocal.\n- [Update account settings](https://docs.dlocal.com/reference/update-settings-v2-platforms.md): This service is responsible for updating account settings like pricing level and settlement period.\n=== overview-payins\n---\nupdatedAt: 2026-04-28T08:41:41.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Overview\n\nFind out how to start integrating dLocal Payins solution.\n\n**dLocal Payins is a payment processing solution that enables businesses to accept payments from customers in various countries and currencies.**\n\nWith dLocal Payins, you can easily integrate multiple payment methods, including credit cards, debit cards, local bank transfers, and cash payments, into your checkout process.\n\n# Connections to Payins\n\nFind ways to connect and integrate with Payins API to start collecting payments.\n\n<br />\n\n[block:html]\n{\n  \"html\": \"<!-- CARDS GRID -->\\n<div class=\\\"grid-container\\\">\\n\\n    <!-- CARD 1 -->\\n    <div class=\\\"card-container\\\">\\n        <div class=\\\"card-first-row\\\">\\n            <img src=\\\"https://files.readme.io/e8fe669-full-api-icon.png\\\" class=\\\"card-first-row-image\\\" alt=\\\"\\\">\\n        </div>\\n        <div class=\\\"card-second-row\\\">\\n            <div class=\\\"card-title\\\">Full API</div>\\n            <p class=\\\"card-p\\\">Direct integration with dLocal, sending information server to server.</p>\\n            <a href=\\\"/docs/full-api\\\" class=\\\"card-link\\\">See more\\n                <svg class=\\\"card-link_arrow\\\" fill=\\\"none\\\" viewBox=\\\"0 0 19 19\\\">\\n                    <path class=\\\"c-link_arrow-color\\\" fill=\\\"#21A35B\\\" stroke=\\\"#21A35B\\\" stroke-width=\\\".3\\\"\\n                        d=\\\"M17.546 8.918l-6.107-6.107a.806.806 0 00-1.163 0 .806.806 0 000 1.162l4.698 4.698H2.036a.828.828 0 00-.598.23c-.15.151-.23.36-.23.598s.08.448.23.598c.15.151.36.231.598.231h12.938l-4.698 4.697a.806.806 0 000 1.163c.33.33.832.33 1.162 0l6.108-6.107a.855.855 0 00.183-.258.781.781 0 00.064-.324c0-.119-.02-.225-.064-.323a.855.855 0 00-.183-.258z\\\">\\n                    </path>\\n                </svg>\\n            </a>\\n        </div>\\n    </div>\\n\\n    <!-- CARD 2 -->\\n    <div class=\\\"card-container\\\">\\n        <div class=\\\"card-first-row\\\">\\n            <img src=\\\"https://files.readme.io/d1f6ba9-smart-fields-icon.png\\\" class=\\\"card-first-row-image\\\" alt=\\\"\\\">\\n        </div>\\n        <div class=\\\"card-second-row\\\">\\n            <div class=\\\"card-title\\\">Smart Fields</div>\\n            <p class=\\\"card-p\\\">Customizable UI components for building checkout forms on your site.</p>\\n            <a href=\\\"/docs/smart-fields\\\" class=\\\"card-link\\\">See more\\n                <svg class=\\\"card-link_arrow\\\" fill=\\\"none\\\" viewBox=\\\"0 0 19 19\\\">\\n                    <path class=\\\"c-link_arrow-color\\\" fill=\\\"#21A35B\\\" stroke=\\\"#21A35B\\\" stroke-width=\\\".3\\\"\\n                        d=\\\"M17.546 8.918l-6.107-6.107a.806.806 0 00-1.163 0 .806.806 0 000 1.162l4.698 4.698H2.036a.828.828 0 00-.598.23c-.15.151-.23.36-.23.598s.08.448.23.598c.15.151.36.231.598.231h12.938l-4.698 4.697a.806.806 0 000 1.163c.33.33.832.33 1.162 0l6.108-6.107a.855.855 0 00.183-.258.781.781 0 00.064-.324c0-.119-.02-.225-.064-.323a.855.855 0 00-.183-.258z\\\">\\n                    </path>\\n                </svg>\\n            </a>\\n        </div>\\n    </div>\\n\\n    <!-- CARD 3 -->\\n    <div class=\\\"card-container\\\">\\n        <div class=\\\"card-first-row\\\">\\n            <img src=\\\"https://files.readme.io/d57dd72-checkout-redirect-icon.png\\\" class=\\\"card-first-row-image\\\" alt=\\\"\\\">\\n        </div>\\n        <div class=\\\"card-second-row\\\">\\n            <div class=\\\"card-title\\\">Checkout redirect</div>\\n            <p class=\\\"card-p\\\">Pre-built checkout and vouchers for an easier implementation.</p>\\n            <a href=\\\"/docs/integrate-checkout\\\" class=\\\"card-link\\\">See more\\n                <svg class=\\\"card-link_arrow\\\" fill=\\\"none\\\" viewBox=\\\"0 0 19 19\\\">\\n                    <path class=\\\"c-link_arrow-color\\\" fill=\\\"#21A35B\\\" stroke=\\\"#21A35B\\\" stroke-width=\\\".3\\\"\\n                        d=\\\"M17.546 8.918l-6.107-6.107a.806.806 0 00-1.163 0 .806.806 0 000 1.162l4.698 4.698H2.036a.828.828 0 00-.598.23c-.15.151-.23.36-.23.598s.08.448.23.598c.15.151.36.231.598.231h12.938l-4.698 4.697a.806.806 0 000 1.163c.33.33.832.33 1.162 0l6.108-6.107a.855.855 0 00.183-.258.781.781 0 00.064-.324c0-.119-.02-.225-.064-.323a.855.855 0 00-.183-.258z\\\">\\n                    </path>\\n                </svg>\\n            </a>\\n        </div>\\n    </div>\\n  \\n\\n    <!-- CARD 5 -->\\n    <div class=\\\"card-container\\\">\\n        <div class=\\\"card-first-row\\\">\\n            <img src=\\\"https://files.readme.io/f22f8fa-payment-links-icon.png\\\" class=\\\"card-first-row-image\\\" alt=\\\"\\\">\\n        </div>\\n        <div class=\\\"card-second-row\\\">\\n            <div class=\\\"card-title\\\">Payment links</div>\\n            <p class=\\\"card-p\\\">Start processing cross-border within minutes without a single line of code.</p>\\n            <a href=\\\"/docs/payment-links\\\" class=\\\"card-link\\\">See more\\n                <svg class=\\\"card-link_arrow\\\" fill=\\\"none\\\" viewBox=\\\"0 0 19 19\\\">\\n                    <path class=\\\"c-link_arrow-color\\\" fill=\\\"#21A35B\\\" stroke=\\\"#21A35B\\\" stroke-width=\\\".3\\\"\\n                        d=\\\"M17.546 8.918l-6.107-6.107a.806.806 0 00-1.163 0 .806.806 0 000 1.162l4.698 4.698H2.036a.828.828 0 00-.598.23c-.15.151-.23.36-.23.598s.08.448.23.598c.15.151.36.231.598.231h12.938l-4.698 4.697a.806.806 0 000 1.163c.33.33.832.33 1.162 0l6.108-6.107a.855.855 0 00.183-.258.781.781 0 00.064-.324c0-.119-.02-.225-.064-.323a.855.855 0 00-.183-.258z\\\">\\n                    </path>\\n                </svg>\\n            </a>\\n        </div>\\n    </div>\\n\\n    <!-- CARD 6 -->\\n    <div class=\\\"card-container\\\">\\n        <div class=\\\"card-first-row\\\">\\n            <img src=\\\"https://files.readme.io/b8b55e4-invoices-icon.png\\\" class=\\\"card-first-row-image\\\" alt=\\\"\\\">\\n        </div>\\n        <div class=\\\"card-second-row\\\">\\n            <div class=\\\"card-title\\\">Plugins and wallets</div>\\n            <p class=\\\"card-p\\\">Integrate through an e-commerce platform or connect a digital wallet.</p>\\n            <a href=\\\"/docs/plugins-wallets\\\" class=\\\"card-link\\\">See more\\n                <svg class=\\\"card-link_arrow\\\" fill=\\\"none\\\" viewBox=\\\"0 0 19 19\\\">\\n                    <path class=\\\"c-link_arrow-color\\\" fill=\\\"#21A35B\\\" stroke=\\\"#21A35B\\\" stroke-width=\\\".3\\\"\\n                        d=\\\"M17.546 8.918l-6.107-6.107a.806.806 0 00-1.163 0 .806.806 0 000 1.162l4.698 4.698H2.036a.828.828 0 00-.598.23c-.15.151-.23.36-.23.598s.08.448.23.598c.15.151.36.231.598.231h12.938l-4.698 4.697a.806.806 0 000 1.163c.33.33.832.33 1.162 0l6.108-6.107a.855.855 0 00.183-.258.781.781 0 00.064-.324c0-.119-.02-.225-.064-.323a.855.855 0 00-.183-.258z\\\">\\n                    </path>\\n                </svg>\\n            </a>\\n        </div>\\n    </div>\\n\\n</div>\\n\\n\\n<style>\\n    .grid-container {\\n        display: grid;\\n        grid-template-columns: 1fr 1fr;\\n        grid-gap: 2px 20px;\\n        width: 740px;\\n        display: flex;\\n        flex-wrap: wrap;\\n        margin: 20px auto 20px auto;\\n    }\\n\\n    .card-container {\\n        display: flex;\\n        width: 360px;\\n        margin-bottom: 1rem;\\n        min-height: 192px;\\n        border-radius: 16px;\\n        overflow: hidden;\\n        box-shadow: 0 0 0px 1px #D2D8EC;\\n        transition: shadow 200ms ease-out;\\n    }\\n\\n    .card-container:has(.card-link:hover) {\\n        box-shadow: 0 0 0px 1px #2d59f5;\\n        cursor: pointer;\\n        border-radius: 16px;\\n        transition: shadow 200ms ease-out;\\n    }\\n\\n    div:not(.markdown-body) .card-link:hover {\\n        color: #2d59f5 !important;\\n    }\\n\\n    div:not(.markdown-body) .card-link:hover .c-link_arrow-color {\\n        fill: #2d59f5;\\n    }\\n\\n    .card-first-row {\\n        flex: 0.80;\\n        background-color: #2D59F5;\\n        margin: -2px;\\n    }\\n\\n\\n    .card-first-row-image {\\n        width: 2.813rem;\\n        margin: 2rem auto 50% auto;\\n        display: block !important;\\n    }\\n\\n    .card-second-row {\\n        flex: 2;\\n        padding: 2.75rem 2rem;\\n    }\\n\\n    .card-content {\\n        padding: auto;\\n        display: block;\\n    }\\n\\n    .card-title {\\n        font-size: 1.1rem;\\n        font-weight: 700;\\n        margin: 0px 0px 17px 0px;\\n        font-family: var(--font-alt);\\n    }\\n\\n\\n    .card-p {\\n        font-size: 0.75rem !important;\\n        line-height: 1.7rem !important;\\n    }\\n\\n    .card-link {\\n        font-size: 0.875rem !important;\\n        color: #21A35B;\\n        text-decoration: none;\\n        font-weight: 500 !important;\\n    }\\n\\n    .card-link_arrow {\\n        display: inline-block;\\n        width: 1em;\\n        height: auto;\\n        vertical-align: middle;\\n        margin-top: -0.15em;\\n    }\\n\\n    @media only screen and (max-width: 1357px) {\\n        .grid-container {\\n            grid-template-columns: 1fr;\\n            grid-gap: 10px;\\n            width: 100%;\\n            margin: 20px auto 20px auto;\\n        }\\n\\n        .card-container {\\n            display: flex;\\n            width: 100%;\\n            min-height: 50px;\\n        }\\n\\n        .card-second-row {\\n            padding: 1.2rem 2rem;\\n        }\\n\\n        .card-first-row-image {\\n            margin: 2rem auto 70% auto;\\n        }\\n    }\\n</style>\"\n}\n[/block]\n\n## Features and capabilities\n\nCompare the main functions which best adapt your business.\n\n|                       |    Full API    |   Smart Fields  |  Checkout redirect |    Payment links   |\n| :-------------------- | :------------: | :-------------: | :----------------: | :----------------: |\n| Integration effort    |       +++      |        ++       |          -         |          0         |\n| UI customization      | Customize full | Customizable UI | Customize branding | Customize branding |\n| Payment Flow          |      Sync      |       Sync      |      Async\\*\\*     |      Async\\*\\*     |\n| PCI Compliance        |  AOC - PCI DSS |      SAQ-A      |         N/A        |         N/A        |\n| Merchant Flow control |       Yes      |       Yes       |         No         |         No         |\n| Recurrence            |       Yes      |       Yes       |         No         |         No         |\n\n\\*\\* In synchronous flows, the final status of the transaction is received in the response of the API request. In asynchronous flows, as the user operates outside the merchant's portal, the final notification has a delay.\n\n## Card integration\n\nTo determine which card integration you need, follow the diagram below.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c05d94e8c33e06ddd4443cb2d668adf357d16ebd7e0cec98f2ecbd7f99ba821c-Payins_Overview.png\",\n        null,\n        \"\"\n      ],\n      \"align\": \"center\"\n    }\n  ]\n}\n[/block]\n\n# Payment types\n\nGet to know more information about the different payment types and options for each country.\n\n[block:html]\n{\n  \"html\": \"<style>\\n  \\n  .main {\\n    margin-left: auto;\\n    margin-right: auto;\\n    margin-bottom: 5px;\\n    display: grid;\\n    grid-template-columns: repeat(2, 1fr); /* Dos columnas */\\n}\\n\\n.overview-card1 {\\n    position: relative; /* Asegúrate de que el contenedor sea relativo para posicionar el pseudoelemento */\\n    width: 100%;\\n    box-sizing: border-box;\\n    margin: 0;\\n}\\n\\n.overview-card1::after {\\n    content: '';\\n    position: absolute;\\n    right: 0; /* Pega la línea al borde derecho */\\n    top: 30%; /* Ajusta la posición superior de la línea */\\n    height: 70%; /* Establece el alto de la línea al 60% */\\n    width: 1px; /* Grosor de la línea */\\n    background-color: #D2D8EC; /* Color de la línea */\\n}\\n\\n  .overview-card2 {\\n    position: relative; /* Asegúrate de que el contenedor sea relativo para posicionar el pseudoelemento */\\n    width: 100%;\\n    box-sizing: border-box;\\n    margin: 0;\\n}\\n\\n  \\n.overview-card-upper-side1 {\\n    height: 105px;\\n    padding: 20px;\\n    background-color: transparent;\\n    text-align: left;\\n}\\n\\n.overview-card-bottom-side {\\n    position: relative;\\n    width: 100%;\\n    height: 100%;\\n    padding: 30px;\\n    padding-right: 20px;\\n    background-color: transparent;\\n    border-radius: 16px;\\n}\\n\\n.overview-card-title1 {\\n    font-family: 'Plus Jakarta Sans', sans-serif;\\n    font-size: 24px;\\n    font-weight: 700;\\n    line-height: 26.4px;\\n}\\n\\n.overview-card-content1 {\\n    font-size: 14px;\\n    font-weight: 300;\\n    margin-top: 20px;\\n    line-height: 20px;\\n    margin-bottom: 40px!important;\\n}\\n\\n.overview-icon1 {\\n    margin-bottom: -5px;\\n    margin-top: 20px;\\n}\\n  \\n.doc-link {\\n        position: relative;\\n        font-weight: 500;\\n        color: #21A35B !important;\\n        text-decoration: none;\\n        display: block;\\n    }\\n  \\n\\ndiv:not(.markdown-body) .doc-link:hover {\\n            text-decoration: none;\\n            color: #1043FA !important;\\n            transform: translateX(0.2em);\\n        }\\n\\n.overview-card-title1:hover {\\n    color: #2D59F5 !important;\\n    cursor:pointer;\\n    transform: none!important;\\n}\\n\\n    div:not(.markdown-body) .doc-link_arrow {\\n        display: inline-block;\\n        height: 1em;\\n        width: auto;\\n        vertical-align: middle;\\n        margin-left: 0.2em;\\n        margin-top: -0.1em;\\n    }\\n  \\n     div:not(.markdown-body) .doc-link:hover .doc-link_arrow-color {\\n            fill: #1043FA !important;\\n        }\\n  \\n   [data-color-mode=\\\"dark\\\"] .overview-icon1 img {\\n    filter: brightness(0) invert(1);\\n    transition: filter 0.3s ease;\\n  }\\n\\n\\n/* Media Queries para dispositivos móviles */\\n@media (max-width: 768px) {\\n  .main {\\n    grid-template-columns: repeat(2, 1fr); /* Dos columnas en pantallas medianas */\\n  }\\n}\\n\\n@media (max-width: 480px) {\\n  .main {\\n    grid-template-columns: 1fr; /* Una columna en pantallas pequeñas */\\n}\\n</style>\\n  \\n    <div class=\\\"main\\\">\\n\\n      \\n      <!-- Cards -->\\n      <div\\n        class=\\\"overview-card1\\\" onclick=\\\"parent.location='/docs'\\\">\\n        <div class=\\\"overview-card-bottom-side\\\">\\n                 <div class=\\\"overview-icon1\\\" style=\\\"padding-bottom: 6px;\\\"><img width=\\\"48\\\" src=\\\"https://files.readme.io/cb63dce277de8c5b9cf2c6199ee707ee7390c8165861c2e4c657b06ce689fd9d-credit-card.png\\\"  alt=\\\"\\\" loading=\\\"lazy\\\"><div class=\\\"img_overlay img_color_rgba(0,0,0,.2)\\\"></div></div>\\n           <h3 class=\\\"overview-card-title1\\\">Cards</h3>\\n          <p class=\\\"overview-card-content1\\\">\\n           Accept card payments with the solution that best suits your needs.  \\n          </p>\\n          <a href=\\\"/docs/card-payments\\\" class=\\\"doc-link\\\">Card payments</a>\\n        </div>\\n      </div>  \\n      \\n      <!-- APM -->\\n      <div class=\\\"overview-card2\\\" onclick=\\\"parent.location='/docs'\\\">\\n    <div class=\\\"overview-card-bottom-side\\\">\\n             <div class=\\\"overview-icon1\\\"><img width=\\\"48\\\" src=\\\"https://files.readme.io/960b47600b93dbf7b2f3eb65c6f1d9fef60fbb25ee610ba165d1e6b8fc957354-money-stack.svg\\\"  alt=\\\"\\\" loading=\\\"lazy\\\"><div class=\\\"img_overlay img_color_rgba(0,0,0,.2)\\\"></div></div>\\n           <h3 class=\\\"overview-card-title1\\\">Cash</h3>\\n          <p class=\\\"overview-card-content1\\\">\\n             Cash is king in emerging markets. As card payments penetration is low, many consumers, aimed by local culture, prefer cash payments in physical stores.\\n        </p>\\n          <a href=\\\"/docs/bank-transfer-payment\\\" class=\\\"doc-link\\\">Bank transfer</a>\\n          <a href=\\\"/docs/cash-payments\\\" class=\\\"doc-link\\\">Ticket</a>\\n          <a href=\\\"/docs/wallet-payments\\\" class=\\\"doc-link\\\">Digital wallet</a>\\n          <a href=\\\"/docs/mobile-money-payments\\\" class=\\\"doc-link\\\">Mobile money transfer</a>\\n        </div>\\n      </div> \\n      \\n    </div>\"\n}\n[/block]","type":"text"}]}

cd /tmp && python3 - <<'EOF'
import re
for f in ['integrate-checkout.md','payins-security.md','get-api-credentials.md']:
    t=open(f,encoding='utf-8').read()
    t=re.sub(r'\[block:html\].*?\[/block\]','',t,flags=re.S)
    t=re.sub(r'\[block:image\].*?\[/block\]','[image]',t,flags=re.S)
    print("="*30,f)
    print(t[:9000])
EOF

{"content":[{"text":"============================== integrate-checkout.md\n---\nupdatedAt: 2026-09-25T21:31:59.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Checkout redirect\n\nEasily activate payments with dLocal’s Checkout solution.\n\nSave time by integrating dLocal's Checkout, a pre-built workflow with all payment methods.\n\nIn this type of integration, the customer is redirected to a secure dLocal page, where the payment is completed. It doesn’t require PCI certification.\n\n<Image src=\"https://files.readme.io/59dc41e3cf9958a43d858b0118592898d09853c24374b99a5f05b89240527434-Checkout_-BRL_Portugues.png\" align=\"center\" />\n\n<br />\n\n# How does it work\n\n<br />\n\n<details>\n<summary class=\"summary_head\">\n\n#### 1. Create a payment request\n\n</summary>\n\n<br />\n\nMake a POST request to the payments endpoint with the JSON body. Include all necessary information: amount, currency, payer details, etc.\n\n</details>\n\n***\n\n<details>\n<summary class=\"summary_head\">\n\n#### 2. Redirect the customer\n\n</summary>\n\n<br />\n\nUpon successful request, you will receive a response that contains a unique link (`redirect_url`). Redirect your customers to that link so they can enter payment details.\n\n> By default, the Redirect URL can only be used one time.\n\n</details>\n\n***\n\n<details>\n<summary class=\"summary_head\">\n\n#### 3. Customer completes payment\n\n</summary>\n\n<br />\n\nThe customer fills in their details (for the method you specified or any method, depending on your configuration), and our system processes the payment.\n\n</details>\n\n***\n\n<details>\n<summary class=\"summary_head\">\n\n#### 4. Get payment notification\n\n</summary>\n\n<br />\n\nYour `notification_url` receives asynchronous updates about the transaction status. Upon completion, you can confirm the status (e.g., approved, declined) in your system.\n\nWhen the payment status changes, an IPN is triggered, notifying the new status. The endpoint listening to this status can either be specified dynamically on a transaction level or statically at dLocal’s dashboard.\n\n</details>\n\n***\n\n# Checkout available configurations\n\nChoose the best checkout experience for your customer based on their preferred payment flow.\n\n* **1-Step Checkout**. Redirects the customer directly to the payment flow for a specific payment method (e.g., Cards).\n* **2-Step Checkout**. Redirects the customer to a page where they can select from any available payment method (e.g., Cards, Banks, Wallets, etc.).\n\n## 1-Step Checkout: Default payment method\n\nRedirect the customer directly to the payment flow for a specific payment method (e.g. Cards).\n\n### Integration steps\n\n* **Set&#x20;**`payment_method_flow`**&#x20;to&#x20;**`REDIRECT`**.**<br />This indicates that the customer should be redirected to the dLocal-hosted payment page.\n* **Include a&#x20;**`payment_method_id`**, such as&#x20;**`CARD`**.**<br />This tells the API that the payment page should preselect and process the transaction using the specified payment method.\n* Send the JSON request to the payment API endpoint and **retrieve the redirect URL**.\n\n### Example request\n\nAll payment requests should be made to the `/payments` endpoint.\n\nYou can find more information about this request on the [Create payment page](https://docs.dlocal.com/reference/create-payment).\n\n```json Example request\ncurl -X POST \\\n    -H 'X-Date: {x-date}' \\\n    -H 'X-Login: {x-login}' \\\n    -H 'X-Trans-Key: {x-trans-key}' \\\n    -H 'Content-Type: application/json' \\\n    -H 'X-Version: 2.1' \\\n    -H 'User-Agent: MerchantTest / 1.0 ' \\\n    -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n    -d '{body}'\n   https://api.dlocal.com/payments \n\n{\n    \"amount\": 120.00,\n    \"currency\" : \"BRL\",\n    \"country\": \"BR\",\n    \"payment_method_id\" : \"CARD\",\n    \"payment_method_flow\" : \"REDIRECT\",\n    \"payer\":{\n        \"name\" : \"Thiago Gabriel\",\n        \"email\" : \"thiago@example.com\",\n        \"document\" : \"53033315550\",\n        \"address\": {\n            \"state\"  : \"Rio de Janeiro\",\n            \"city\" : \"Volta Redonda\",\n            \"zip_code\" : \"27275-595\",\n            \"street\" : \"Servidao B-1\",\n            \"number\" : \"1106\"\n        }\n    }, \n    \"order_id\": \"657434343\",\n    \"notification_url\": \"http://merchantsite.com/notifications\"\n}\n\n```\n```json Example response\n{ \n    \"id\": \"D-4-086e1efe-c391-4226-992f-5e1d8664a297\", \n    \"amount\": 120.00, \n    \"currency\": \"BRL\", \n    \"payment_method_type\": \"CARD\",\n    \"payment_method_flow\": \"REDIRECT\", \n    \"country\": \"BR\", \n    \"created_date\": \"2019-01-09T20:08:49.000+0000\", \n    \"status\": \"PENDING\", \n    \"status_detail\": \"The payment is pending\", \n    \"status_code\": \"100\", \n    \"order_id\": \"Zh3gb4jhbg34Vj\", \n    \"notification_url\": \"http://merchantsite.com/notifications\", \n    \"redirect_url\": \"https://pay.dlocal.com/checkout/R-4-8b4f332f-b2fe-4f35-9cc1-632533d8...\" \n}\n```\n\n## 2-Step Checkout: Display payment methods\n\nRedirect the customer to a page where they can pick any available payment method (e.g., Cards, Banks, Wallets, etc.).\n\n### Integration steps\n\n1. **Set&#x20;**`payment_method_flow`**&#x20;to&#x20;**`REDIRECT`**.**<br />This indicates that the customer should be redirected to the dLocal-hosted payment page. The checkout page will list all available payment methods.\n2. Send the JSON request to the payment API endpoint and **retrieve the redirect URL**.\n\n### Example request\n\nAll payment requests should be made to the `/payments` endpoint.\n\nYou can find more information about this request on the [Create payment page](https://docs.dlocal.com/reference/create-payment).\n\n```json Example request\ncurl -X POST \\\n    -H 'X-Date: {x-date}' \\\n    -H 'X-Login: {x-login}' \\\n    -H 'X-Trans-Key: {x-trans-key}' \\\n    -H 'Content-Type: application/json' \\\n    -H 'X-Version: 2.1' \\\n    -H 'User-Agent: MerchantTest / 1.0 ' \\\n    -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n    -d '{body}'\n   https://api.dlocal.com/payments \n\n{\n    \"amount\": 120.00,\n    \"currency\" : \"BRL\",\n    \"country\": \"BR\",\n    \"payment_method_flow\" : \"REDIRECT\",\n    \"payer\":{\n        \"name\" : \"Thiago Gabriel\",\n        \"email\" : \"thiago@example.com\",\n        \"document\" : \"53033315550\",\n        \"address\": {\n            \"state\"  : \"Rio de Janeiro\",\n            \"city\" : \"Volta Redonda\",\n            \"zip_code\" : \"27275-595\",\n            \"street\" : \"Servidao B-1\",\n            \"number\" : \"1106\"\n        }\n    },   \n    \"order_id\": \"657434343\",\n    \"notification_url\": \"http://merchantsite.com/notifications\"\n}\n```\n```json Example response\n{ \n    \"id\": \"D-4-086e1efe-c391-4226-992f-5e1d8664a297\", \n    \"amount\": 120.00, \n    \"currency\": \"BRL\", \n    \"payment_method_flow\": \"REDIRECT\", \n    \"country\": \"BR\", \n    \"created_date\": \"2019-01-09T20:08:49.000+0000\", \n    \"status\": \"PENDING\", \n    \"status_detail\": \"The payment is pending\", \n    \"status_code\": \"100\", \n    \"order_id\": \"Zh3gb4jhbg34Vj\", \n    \"notification_url\": \"http://merchantsite.com/notifications\", \n    \"redirect_url\": \"https://pay.dlocal.com/checkout/R-4-8b4f332f-b2fe-4f35-9cc1-632533d8...\" \n}\n```\n\n## Save a card or set up recurring payments\n\nWhen the customer pays with a card through Checkout Redirect (no `payment_method_id` in the request), you can also save the card for future use. Include one of these two objects on the same `/payments` request. They are mutually exclusive.\n\n* `save_payment_method`: saves the card so you can charge it again later, either by the customer (`on_file`) or by you (`unscheduled`).\n* `subscription`: saves the card and sets up a fixed, recurring charge on it.\n\n### On\\_file: save the card for future payments\n\nUse this when the customer will come back to pay again themselves, so they can reuse the card in one click instead of entering it again.\n\n#### Example request\n\nAll payment requests should be made to the `/payments` endpoint.\n\nYou can find more information about this request on the [Create payment page](https://docs.dlocal.com/reference/create-payment).\n\n```shell Example request\ncurl -X POST \\\n    -H 'X-Date: {x-date}' \\\n    -H 'X-Login: {x-login}' \\\n    -H 'X-Trans-Key: {x-trans-key}' \\\n    -H 'Content-Type: application/json' \\\n    -H 'X-Version: 2.1' \\\n    -H 'User-Agent: MerchantTest / 1.0 ' \\\n    -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n    -d '{body}'\n   https://api.dlocal.com/payments\n{\n    \"amount\": 45.00,\n    \"currency\": \"BRL\",\n    \"country\": \"BR\",\n    \"payment_method_flow\": \"REDIRECT\",\n    \"payer\": {\n        \"name\": \"Thiago Gabriel\",\n        \"email\": \"thiago@example.com\",\n        \"document\": \"53033315550\"\n    },\n    \"order_id\": \"657434344\",\n    \"notification_url\": \"http://merchantsite.com/notifications\",\n    \"save_payment_method\": {\n        \"mode\": \"on_file\",\n        \"ask_consent\": true\n    }\n}\n```\n```json Example response\n{\n    \"id\": \"D-4-086e1efe-c391-4226-992f-5e1d8664a298\",\n    \"amount\": 45.00,\n    \"currency\": \"BRL\",\n    \"payment_method_flow\": \"REDIRECT\",\n    \"country\": \"BR\",\n    \"created_date\": \"2026-09-25T10:15:00.000+0000\",\n    \"status\": \"PENDING\",\n    \"status_detail\": \"The payment is pending\",\n    \"status_code\": \"100\",\n    \"order_id\": \"657434344\",\n   \n============================== payins-security.md\n---\nupdatedAt: 2026-03-03T17:20:00.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Security\n\nLearn how to set up the headers for making API requests, and encrypt sensitive information.\n\nEach request to the dLocal API must include a signature. The signature is necessary to verify that the information that is being sent is valid and secure.\n\n# Signature\n\n## Required information\n\n* [x] **API credentials**. Access the dLocal Merchant Dashboard with your dLocal account to <a href=\"https://dashboard.dlocal.com/settings/integration\" target=\"_blank\">obtain your API keys credentials</a>.\n* [x] **Custom information**. Calculate and complete the necessary data such as the payment date information.\n* [x] **Hash**. Convert all the information (letters and numbers) into an encrypted output of a fixed length using the HMAC-SHA256 algorithm.\n\n## How does it work\n\nAll calls to the Payins API should be signed using the HMAC-SHA256 algorithm, and the contents of the signature included in the `Authorization` header as documented below. This header should have as prefix the signature version and the hash function used, which is currently **V2-HMAC-SHA256**.\n\n## Headers\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Header\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"`X-Date`\",\n    \"0-1\": \"String\",\n    \"0-2\": \"ISO8601 datetime with UTC timezone. E.g.: `2018-07-12T13:46:28.629Z`.\",\n    \"1-0\": \"`X-Login`\",\n    \"1-1\": \"String\",\n    \"1-2\": \"Sent as a header to identify the merchant making the request. Find your keys in the <a href=\\\"https://dashboard.dlocal.com/settings/integration\\\" target=\\\"_blank\\\">Merchant Dashboard</a>.\",\n    \"2-0\": \"`X-Trans-Key`\",\n    \"2-1\": \"String\",\n    \"2-2\": \"Sent as a header along with `x-login` to authenticate the request. Find your keys in the <a href=\\\"https://dashboard.dlocal.com/settings/integration\\\" target=\\\"_blank\\\">Merchant Dashboard</a>.\",\n    \"3-0\": \"`Content-Type`\",\n    \"3-1\": \"String\",\n    \"3-2\": \"Always complete `application/json`\",\n    \"4-0\": \"`X-Version`\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Current API Version number: ` 2.1`\",\n    \"5-0\": \"`User-Agent`\",\n    \"5-1\": \"String\",\n    \"5-2\": \"Used to identify the application type, operating system, software vendor, or software version of the requesting software user agent.\",\n    \"6-0\": \"`Authorization`\",\n    \"6-1\": \"String\",\n    \"6-2\": \"Use the [required information](https://docs.dlocal.com/reference/payins-security#required-information) mentioned before and set this field with the following structure: V2-HMAC-SHA256, Signature: \\\\<hmac(`secretKey`, \\\"`X-Login`+`X-Date`+`RequestBody`\\\")>\"\n  },\n  \"cols\": 3,\n  \"rows\": 7,\n  \"align\": [\n    \"left\",\n    \"left\",\n    \"left\"\n  ]\n}\n[/block]\n\n> ℹ️ Secret key credential\n>\n> Do not forget to use your Secret key for masking your signature. Read more information in the [Get your API test credentials](https://docs.dlocal.com/docs/get-api-credentials) section.\n\n## Example Request\n\n```json\ncurl -X POST \\\n   -H 'X-Date: {x-date}' \\\n   -H 'X-Login: {x-login}' \\\n   -H 'X-Trans-Key: {x-trans-key}' \\\n   -H 'Content-Type: application/json' \\\n   -H 'X-Version: 2.1' \\\n   -H 'User-Agent: MerchantTest / 1.0 ' \\\n   -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n   -d '{body}'\n    https://api.dlocal.com/payments\n```\n\n## Examples of HMAC signature generation\n\nOur GitHub repository hosts a variety of signature examples, which can be a valuable resource for understanding implementation details and for reference in your development process.\n\n[Check out signature examples on GitHub > ](https://github.com/tam-dlocal/Starter-Code-Examples)\n\n```javascript Java\nimport java.io.ByteArrayOutputStream;\nimport java.io.IOException;\nimport java.security.InvalidKeyException;\nimport java.security.NoSuchAlgorithmException;\nimport java.util.Formatter;\nimport javax.crypto.Mac;\nimport javax.crypto.spec.SecretKeySpec;\n\npublic final class SignatureCalculator {\n\n    private static final String HMAC_ALGORITHM = \"HmacSHA256\";\n    private static final String CHARSET = \"UTF-8\";\n\n    public static String calculateSignature(String x_Login, String x_Date, String secretKey, String body)\n        throws IOException, InvalidKeyException, NoSuchAlgorithmException {\n\n        // Create byte array with the required data for the signature.\n        ByteArrayOutputStream bout = new ByteArrayOutputStream();\n        bout.write(x_Login.getBytes(CHARSET));\n        bout.write(x_Date.getBytes(CHARSET));\n        bout.write(body.getBytes(CHARSET));\n\n        // Calculate the signature.\n        SecretKeySpec signingKey = new SecretKeySpec(secretKey.getBytes(), HMAC_ALGORITHM);\n        Mac mac = Mac.getInstance(HMAC_ALGORITHM);\n        mac.init(signingKey);\n        byte[] signature = mac.doFinal(bout.toByteArray());\n\n        // Create a String with the signature value.\n        Formatter formatter = new Formatter();\n        for (byte b : signature) {\n            formatter.format(\"%02x\", b);\n        }\n        return formatter.toString();\n    }\n}\n```\n```javascript PHP\n$signature = hash_hmac(\"sha256\", \"$X-Login$X-Date$RequestBody\", $secretKey);\n```\n```javascript Python\nsignature = hmac.new(secretKey, X-Login+X-Date+RequestBody, hashlib.sha256).hexdigest()\n```\n```javascript Ruby\nsignature = OpenSSL::HMAC.hexdigest('sha256', secretKey, $X-Login + $X-Date + RequestBody)\n\n```\n```typescript Typescript\nimport * as crypto from 'crypto';\n\nclass SignatureCalculator {\n    calculateSignature(timestamp: string, body?: string): string {\n        let message: string = process.env.DLOCAL_X_LOGIN + timestamp;\n\n        if (body) {\n            message += body;\n        }\n\n        const hmac = crypto.createHmac('sha256', process.env.DLOCAL_SECRET_KEY);\n        hmac.update(message, 'utf-8');\n        const signature: string = hmac.digest('hex');\n\n        return `V2-HMAC-SHA256, Signature: ${signature}`;\n    }\n}\n\n// Example usage\nconst calculator = new SignatureCalculator();\nconst timestamp = new Date().toISOString(); // Corrected the timestamp\nconst body = \"yourRequestBody\";\nconst result = calculator.calculateSignature(timestamp, body);\nconsole.log(result);\n```\n```javascript Javascript\nfunction calculateSignature(timestamp, body) {\n    let message = process.env.DLOCAL_X_LOGIN + timestamp;\n\n    if (body) {\n        message += body;\n    }\n\n    const hmac = crypto.createHmac('sha256', process.env.DLOCAL_SECRET_KEY);\n    hmac.update(message, 'utf-8');\n    const signature = hmac.digest('hex');\n\n    return `V2-HMAC-SHA256, Signature: ${signature}`;\n}\n\n// Example usage\nconst timestamp = new Date().toISOString(); // Set timestamp to current time\nconst body = \"yourRequestBody\";\nconst result = calculateSignature(timestamp, body);\nconsole.log(result);\n```\n```csharp C#\nstatic string SignatureCalculator(string x_Login, string x_Date, string secretKey, string body)\n    {\n        string concatenatedData = x_Login + x_Date + body;\n        byte[] data = Encoding.UTF8.GetBytes(concatenatedData);\n        byte[] keyBytes = Encoding.UTF8.GetBytes(secretKey);\n\n        using (var hmacsha256 = new HMACSHA256(keyBytes))\n        {\n            byte[] hashBytes = hmacsha256.ComputeHash(data);\n            StringBuilder signatureBuilder = new StringBuilder();\n\n            foreach (byte b in hashBytes)\n            {\n                signatureBuilder.Append(b.ToString(\"x2\"));\n            }\n\n            return signatureBuilder.ToString();\n        }\n    }\n```\n\n> ℹ️ Signature testing\n>\n> We strongly suggest testing your generated signature by [making a test payment](https://docs.dlocal.com/docs/make-a-test-payment) to make sure your signature is working before moving forward with the integration.\n\n***\n\n# Sensitive data encryption\n\nCredit Card data, such as `number` and `cvv`, can be encrypted inside the JSON Request Body using <a href=\"https://tools.ietf.org/html/rfc7516\" target=\"_blank\">JWE</a>. This standard is being widely used in the market, and <a href=\"https://tools.ietf.org/html/rfc7516\" target=\"_blank\">most programming languages have libraries</a> to support it.\\\nThe following parameters can be encrypted and added to a `encrypted_data` field:\n\n## Properties\n\n| Property | Type   | Description               |\n| :------- | :----- | :------------------------ |\n| `cvv`    | String | Credit card security code |\n| `number` | String | Credit card number        |\n\n## Example Credit Card Encrypted Body\n\n```json\n\"card\": {\n    \"holder_name\": \"Thiago Gabriel\",\n    \"expiration_month\": 10,\n    \"expiration_year\": 2040,\n    \"encrypted_data\": \"[encrypted JSON goes here]\"\n}\n```\n\nThe encryption flow is the following:\n\n1. dLocal creates an RSA key pair and issue a certification with a 3rd party authority.\n2. dLocal shares the public key to the merchant using an encrypted method.\n3. The merchant uses this public key to encrypt the `number` and `cvv` into a JSON using JWE, and send it in the API request within the `encrypted_data` field. The rest of the requests can be sent unencrypted.\n4. dLocal decrypts the message using the \n============================== get-api-credentials.md\n---\nupdatedAt: 2026-03-03T17:16:34.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Get your API credentials\n\nLearn everything you need to know about your dLocal API credentials.\n\nAll dLocal API requests require API credentials to verify the call is being made through a valid dLocal account.\n\n# Types of credentials\n\nThere are two types of credentials that you can use:\n\n* **Sandbox credentials**. These credentials allow you to check your integration by sending payments to our Sandbox API. You will be able to view all the transactions through the [Merchant Dashboard](https://dashboard.dlocal.com) in Test mode. We recommend trying the Sandbox API before going live to ensure that your integration works properly.\n* **Productio…

cd /tmp && timeout 40 curl -sSL https://docs.dlocal.com/reference/update-settings-v2-platforms.md | python3 -c "
import sys,re
t=sys.stdin.read(); t=re.sub(r'\[block:[a-z]+\].*?\[/block\]','',t,flags=re.S); print(t[:3500])"

{"content":[{"text":"---\nupdatedAt: 2026-09-07T12:44:51.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Update account settings\n\nThis service is responsible for updating account settings like pricing level and settlement period.\n\n# OpenAPI definition\n\n```json\n{\n  \"openapi\": \"3.1.0\",\n  \"info\": {\n    \"title\": \"Platforms\",\n    \"version\": \"2.0.0\",\n    \"description\": \"Platform API V2\"\n  },\n  \"security\": [\n    {\n      \"X-Date\": [],\n      \"X-Login\": [],\n      \"X-Trans-Key\": [],\n      \"X-Version\": [],\n      \"User-Agent\": [],\n      \"Authorization\": []\n    }\n  ],\n  \"x-explorer-enabled\": false,\n  \"x-proxy-enabled\": false,\n  \"x-samples-languages\": [\n    \"curl\"\n  ],\n  \"servers\": [\n    {\n      \"url\": \"https://marketplace-api.dlocal.com\",\n      \"description\": \"Production base URL\"\n    },\n    {\n      \"url\": \"https://marketplace-api.dlocal-sbox.com\",\n      \"description\": \"Sandbox base URL\"\n    }\n  ],\n  \"tags\": [\n    {\n      \"name\": \"Account management\",\n      \"description\": \"Handle information regarding accounts.\"\n    }\n  ],\n  \"paths\": {\n    \"/v2/accounts/{account_id}/settings\": {\n      \"patch\": {\n        \"tags\": [\n          \"Account management\"\n        ],\n        \"summary\": \"Update account settings\",\n        \"operationId\": \"update-settings-v2-platforms\",\n        \"description\": \"This service is responsible for updating account settings like pricing level and settlement period.\",\n        \"parameters\": [\n          {\n            \"name\": \"account_id\",\n            \"in\": \"path\",\n            \"required\": true,\n            \"schema\": {\n              \"type\": \"string\"\n            },\n            \"description\": \"User’s dLocal account ID.\"\n          }\n        ],\n        \"requestBody\": {\n          \"required\": true,\n          \"content\": {\n            \"application/json\": {\n              \"schema\": {\n                \"$ref\": \"#/components/schemas/Settings\"\n              },\n              \"example\": {\n                \"pricing_level\": \"type_1\",\n                \"settlement_period\": 7,\n                \"installments_responsible\": \"merchant\",\n                \"settlements\": [\n                  {\n                    \"config_delay_days\": 7,\n                    \"country_code\": \"AR\"\n                  },\n                  {\n                    \"config_delay_days\": 5,\n                    \"country_code\": \"AR\",\n                    \"payment_method_type\": \"TICKET\"\n                  },\n                  {\n                    \"config_delay_days\": 14,\n                    \"country_code\": \"AR\",\n                    \"payment_method_id\": \"VD\"\n                  }\n                ]\n              }\n            }\n          }\n        },\n        \"responses\": {\n          \"200\": {\n            \"description\": \"OK\",\n            \"content\": {\n              \"application/json\": {\n                \"schema\": {\n                  \"$ref\": \"#/components/schemas/ResponseUpdateSettings\"\n                },\n                \"example\": {\n                  \"pricing_level\": \"type_1\",\n                  \"settlement_period\": 7,\n                  \"installments_responsible\": \"merchant\",\n                  \"settlements\": [\n                    {\n                      \"config_delay_days\": 7,\n                      \"country_code\": \"AR\"\n                    },\n                    {\n                      \"config_delay_days\": 5,\n                      \"country_code\": \"AR\",\n                      \"payment_method_type\": \"TICKET\"\n                    },\n                    {\n                      \"config_delay_days\": 14,\n                      \"c\n","type":"text"}]}

cd /tmp && timeout 40 curl -sSL https://docs.dlocal.com/docs/make-a-test-payment.md | python3 -c "
import sys,re
t=sys.stdin.read(); t=re.sub(r'\[block:[a-z]+\].*?\[/block\]','',t,flags=re.S); print(t[:4000])"

{"content":[{"text":"---\nupdatedAt: 2026-07-27T09:12:27.000Z\nagentTools:\n  projectIndex: https://docs.dlocal.com/llms.txt\n---\n\n# Make a test payment\n\nLearn how to simulate payments using dLocal’s sandbox environment before going live.\n\nThe dLocal Sandbox is a test environment that mirrors the production system. It allows you to safely simulate payments, check API behavior, and trigger webhooks without processing real transactions.\n\nIn **Test mode**, you can monitor test transactions through the [Merchant Dashboard](https://dashboard.dlocal.com/login). You can manage both sandbox and production from the same account.\n\n# Step 1: Requirements to start testing\n\n* **A dLocal account**. [Sign up](https://dashboard.dlocal.com/signup) or [log in](https://dashboard.dlocal.com/login) if you already have one.\n* **Sandbox API credential**. Get them from the [Settings section](https://dashboard.dlocal.com/settings) in the Dashboard.\n\n# Step 2: How does it work?\n\n## Sandbox URL\n\n\n\n### Sandbox tools URL\n\nFor certain payments, such as cash or refunds, it is necessary to force the status. That's why you need to use this specific one:\n\n\n\n## Steps to test a payment\n\n1. Set up [authentication headers](https://docs.dlocal.com/reference/payins-security#headers).\n2. Build the API request you want to simulate using test data.\n3. Send the request to the sandbox endpoint and simulate different responses.\n4. Check the response and your webhook listener.\n\n## Simulate payment status\n\nIn Sandbox, you can control the payment result by passing a status code in the request body's `description` field.\n\n```json Example\n{\n  \"description\": \"302\"\n}\n```\n\n#### Sample description values to simulate card responses\n\n| `description` | Simulated status | Meaning            |\n| :------------ | :--------------- | :----------------- |\n| `\"200\"`       | PAID             | Payment approved   |\n| `\"300\"`       | REJECTED         | Generic rejection  |\n| `\"302\"`       | REJECTED         | Insufficient funds |\n\n#### Sample description values to simulate cash payments\n\n| `status`     | Meaning           |\n| :----------- | :---------------- |\n| `\"PAID\"`     | Payment approved  |\n| `\"REJECTED\"` | Generic rejection |\n| `\"ERROR\"`    | Generic error     |\n\nAll possible status codes are listed in the [API Reference](https://docs.dlocal.com/reference/postman-api-collection). For specific operations like payments or refunds, you’ll find detailed status codes in their respective sections:\n\n* [Payment status codes →](https://docs.dlocal.com/reference/payment-status-codes)\n* [Refund status codes →](https://docs.dlocal.com/reference/refund-status-codes)\n\n# Step 3: Test payments\n\nBelow are common test cases using the sandbox. This is useful to test status-code-based UI messaging or error categorization.\n\n## General payment example\n\nRefer to the example below and modify the relevant data to build and test payment requests in the sandbox environment. Modifies the `description` field in the payment request to trigger specific outcomes.\n\n> 📘 Endpoint routing for card payments\n>\n> * For payments with raw credit card information (e.g., card number, expiration date, CVV), use `https://api.dlocal.com/secure_payments`.\n> * For card payments utilizing a `card_id` or token, use `https://api.dlocal.com/payments`.\n\n```json General payment example for testing\ncurl -X POST \\\n   -H 'X-Date: {x-date}' \\\n   -H 'X-Login: {x-login}' \\\n   -H 'X-Trans-Key: {x-trans-key}' \\\n   -H 'Content-Type: application/json' \\\n   -H 'X-Version: 2.1' \\\n   -H 'User-Agent: MerchantTest / 1.0 ' \\\n   -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \\\n   -d '{body}'\n    https://sandbox.dlocal.com/secure_payments\n\n{\n  \"amount\": 100,\n  \"currency\": \"USD\",\n  \"country\": \"BR\",\n  \"payment_method_id\": \"CARD\",\n  \"payment_method_flow\": \"DIRECT\",\n  \"payer\": {\n    \"name\": \"Thiago Gabriel\",\n    \"email\": \"thiago@example.com\",\n    \"document\": \"53033315550\",\n    \"user_reference\": \"12345\",\n    \"address\": {\n      \"state\": \"Rio de Janeiro\",\n      \"city\": \"Volta R\n","type":"text"}]}

{"content":[{"text":"  - [Card payments](https://docs.dlocal.com/docs/card-payments.md): Learn how to start receiving card payments.\n  - [Cash payments](https://docs.dlocal.com/docs/cash-payments.md): Learn how to start receiving cash payments.\n  - [Wallet payments](https://docs.dlocal.com/docs/wallet-payments.md): Learn how to start receiving wallet payments.\n- [Brazil / Pix payments](https://docs.dlocal.com/docs/pix-payments.md): Learn how to start receiving Pix payments.\n  - [One-Shot Payments](https://docs.dlocal.com/docs/breb-biometrics-one-shot-payments.md): Learn how to make one-time payments with BreB Biometrics. With this payment method, users can pay by selecting one BreB key and using their device biometrics to complete a payment.\n  - [Recurring flow / payments](https://docs.dlocal.com/docs/breb-biometrics-recurring-payments.md): After the one-time enrollment is ACTIVE, you can create recurring BreB Biometrics payments using /payments with enrollment.id.\n- [Africa / Mobile Money payments](https://docs.dlocal.com/docs/mobile-money-payments.md): Learn how to start receiving Mobile Money payments.\n- [Payments HTTP Errors](https://docs.dlocal.com/reference/http-errors-payments.md): Detailed reference for HTTP error responses in dLocal payment API.\n","type":"text"}]}

{"content":[{"text":"{\n  \"login\": \"DLOCAL_DEMO_LOGIN\",\n  \"secretKey\": \"DLOCAL_DEMO_SECRET\",\n  \"date\": \"2018-07-12T13:46:28.629Z\",\n  \"body\": \"{\\\"amount\\\":120.00,\\\"currency\\\":\\\"BRL\\\"}\",\n  \"signature\": \"b85db936bc55a16e148fbbba7d99debc97aff1cbd525b004a48e02406217f7e5\"\n}\n--- dry run ---\nPOST https://sandbox.dlocal.com/payments\n{\n  \"X-Date\": \"2026-09-29T08:20:15.348Z\",\n  \"X-Login\": \"demo\",\n  \"X-Trans-Key\": \"demo\",\n  \"Content-Type\": \"application/json\",\n  \"X-Version\": \"2.1\",\n  \"User-Agent\": \"dlocal-checkout-example/1.0\",\n  \"Authorization\": \"V2-HMAC-SHA256, Signature: 49d48855885727dcce030af8b1d475f2861b34a7d4af8efcfe908fd0860fef98\"\n}\n{\"payment_method_flow\":\"REDIRECT\",\"amount\":120,\"currency\":\"BRL\",\"country\":\"BR\",\"payer\":{\"name\":\"Thiago Gabriel\",\"email\":\"thiago@example.com\",\"document\":\"53033315550\",\"address\":{\"state\":\"Rio de Janeiro\",\"city\":\"Volta Redonda\",\"zip_code\":\"27275-595\",\"street\":\"Servidao B-1\",\"number\":\"1106\"}},\"order_id\":\"order-1790670015345\",\"notification_url\":\"https://example.com/webhooks/dlocal\"}\n","type":"text"}]}

{"content":[{"text":"  - [Postman API Collection](https://docs.dlocal.com/reference/postman-api-collection.md): Learn how to create and manage online payments using the Postman collection to make requests to the dLocal API.\n- [Search payment methods](https://docs.dlocal.com/reference/search-payment-methods.md): This function returns a list of valid payment methods for the requested country.\n- [Create payment](https://docs.dlocal.com/reference/create-payment.md): Creates a new payment using any of the available payment methods.\n- [Get payment](https://docs.dlocal.com/reference/retrieve-a-payment.md): Retrieve information about an existing payment.\n- [Get payment status](https://docs.dlocal.com/reference/retrieve-a-payment-status.md): Retrieve information about the status of an existing payment.\n- [Cancel pending payment](https://docs.dlocal.com/reference/cancel-alternative-payment.md): Cancel pending payments for alternative payment methods (APMs).\n- [Payment status codes](https://docs.dlocal.com/reference/payment-status-codes.md): Use payment status codes for in-depth situation analysis.\n- [Payments HTTP Errors](https://docs.dlocal.com/reference/http-errors-payments.md): Detailed reference for HTTP error responses in dLocal payment API.\n- [Create enrollment](https://docs.dlocal.com/reference/create-enrollment.md): Creates a new enrollment to enable recurring payments for a payer. Use this endpoint for enrollments **without** an initial payment.\n- [Cancel an enrollment](https://docs.dlocal.com/reference/cancel-an-enrollment.md): Cancels an active enrollment. Once cancelled, no further recurring payments can be initiated against this enrollment.\n- [Create a card](https://docs.dlocal.com/reference/create-a-card.md): Securely register a card with dLocal and receive a `card_id` to use for future payments.\n- [Create an installments plan](https://docs.dlocal.com/reference/create-an-installments-plan.md): This service allows you to create customized installment plans for card payments.\n- [Create unique reference](https://docs.dlocal.com/reference/virtual-account.md): This service generates unique references for virtual account payments.\n- [Make a refund](https://docs.dlocal.com/reference/make-a-refund.md): This service allows you to create and read refunds of an existing payment.\n- [Retrieve a refund](https://docs.dlocal.com/reference/retrieve-a-refund.md): Retrieve information about a refund.\n- [Retrieve an order](https://docs.dlocal.com/reference/retrieve-order-refund.md): Retrieve information about an existing refund order.\n- [Check refund status](https://docs.dlocal.com/reference/retrieve-a-refund-status.md): Retrieve information about the status of a refund.\n- [Refund codes](https://docs.dlocal.com/reference/refund-status-codes.md)\n- [Refunds HTTP Errors](https://docs.dlocal.com/reference/http-errors-refunds.md)\n- [The Payment Method Object](https://docs.dlocal.com/reference/payment-method-object.md): Object that identifies each payment method accepted by dLocal.\n- [The Card Object](https://docs.dlocal.com/reference/the-card-object.md): Detailed reference for the Card object structure and required fields for payment processing.\n- [The Installment Object](https://docs.dlocal.com/reference/the-installment-object.md): Detailed reference for the Installment object properties and how to use them in payment plans.\n- [The Ticket Object](https://docs.dlocal.com/reference/the-ticket-object.md): Detailed reference for the Ticket object used in cash payment methods.\n- [The Bank Transfer Object](https://docs.dlocal.com/reference/the-bank-transfer-object.md): Detailed reference for the Bank Transfer object structure used in bank transfer payments.\n- [The Wallet Object](https://docs.dlocal.com/reference/the-wallet-object.md): The Wallet object represents a digital wallet payment method used to process one-time or recurring payments.\n- [The Refund Object](https://docs.dlocal.com/reference/the-refund-object.md): Detailed reference for the Refund object structure and properties used in refund operations.\n- [The Order Object](https://docs.dlocal.com/reference/the-order-object.md): Detailed reference for the Order object structure and how it's used in payment processing.\n- [The Fields Object](https://docs.dlocal.com/reference/the-fields-object.md): Detailed reference for the Fields object used in creating customized payment forms.\n- [The Field container](https://docs.dlocal.com/reference/the-field-container.md): Detailed reference for implementing and customizing field containers in payment forms.\n- [The PSP Object](https://docs.dlocal.com/reference/the-psp-object.md): Object that represents a Payment Service Provider (bank or financial institution) in the Pix network.\n","type":"text"}]}

cd /tmp && for p in retrieve-a-payment retrieve-a-payment-status make-a-refund; do echo "### $p"; timeout 30 curl -sSL "https://docs.dlocal.com/reference/$p.md" | grep -oE '"/[a-zA-Z0-9_{}/.-]*"' | sort -u | head; done

{"content":[{"text":"### retrieve-a-payment\n\"/payments/{payment_id}\"\n### retrieve-a-payment-status\n\"/payments/{payment_id}/status\"\n### make-a-refund\n\"/refunds\"\n","type":"text"}]}

cd /tmp && timeout 30 curl -sSL https://docs.dlocal.com/reference/make-a-refund.md | python3 -c "
import sys,re
t=sys.stdin.read()
i=t.find('\"post\"')
print(t[i:i+2500])" | grep -vE '^\s*$' | head -60

{"content":[{"text":"\"post\": {\n        \"tags\": [\n          \"Refunds\"\n        ],\n        \"summary\": \"Make a refund\",\n        \"description\": \"This service allows you to create and read refunds of an existing payment.\",\n        \"operationId\": \"make-a-refund\",\n        \"requestBody\": {\n          \"content\": {\n            \"application/json\": {\n              \"schema\": {\n                \"type\": \"object\",\n                \"required\": [\n                  \"payment_id\"\n                ],\n                \"properties\": {\n                  \"payment_id\": {\n                    \"type\": \"string\",\n                    \"description\": \"The payment ID.</br></br>Length: 50.\"\n                  },\n                  \"notification_url\": {\n                    \"type\": \"string\",\n                    \"description\": \"If a refund is pending, the refund confirmation is sent asynchronously to this URL.</br></br>Length: 500.\"\n                  },\n                  \"custom_merchant_name\": {\n                    \"type\": \"string\",\n                    \"description\": \"Custom merchant's name. Recommended if you need to define a different name to show on a payout link request. It's included in the email subject sent to the user as well.</br></br>Length: 100.\"\n                  },\n                  \"amount\": {\n                    \"type\": \"number\",\n                    \"description\": \"The refund amount, always in local currency. If no amount is specified, the total payment amount will be refunded by default. Required if `currency` is present.<br>This is mandatory for refunds with splits.</br></br>Length: 16,2. Example 9999999999999999.99\",\n                    \"format\": \"float\"\n                  },\n                  \"currency\": {\n                    \"type\": \"string\",\n                    \"description\": \"Currency of the Amount. Required if `amount` is present.</br></br>Length: 3.\"\n                  },\n                  \"description\": {\n                    \"type\": \"string\",\n                    \"description\": \"Description of the refund.</br></br>Length: 200.\"\n                  },\n                  \"order_refund_id\": {\n                    \"type\": \"string\",\n                    \"description\": \"ID given by the merchant in their system.<br><br>Length: 125.\"\n                  },\n                  \"beneficiary_name\": {\n                    \"type\": \"string\",\n                    \"description\": \"User's first name. Recommended if the `type` of the payment is `TICKET` or `BANK_TRANSFER`.</br></br>Length: 50.\"\n                  },\n","type":"text"}]}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/src/refund.js.","type":"text"}],"details":{"diff":"    ...\n 11 const get = (flag) => {\n 12   const i = argv.indexOf(flag);\n 13   return i === -1 ? undefined : argv[i + 1];\n 14 };\n-15 const id = argv.find((a) => !a.startsWith(\"--\") && argv[argv.indexOf(a) - 1] !== \"--amount\" && argv[argv.indexOf(a) - 1] !== \"--currency\");\n+15 const id = argv.find(\n+16   (a, i) => !a.startsWith(\"--\") && ![\"--amount\", \"--currency\"].includes(argv[i - 1]),\n+17 );\n 16 \n 17 if (!id) {\n 18   console.error(\"Usage: npm run refund -- <payment-id> [--amount N --currency XXX]\");\n 19   process.exit(2);\n    ...","patch":"--- /sandbox/repo/src/refund.js\n+++ /sandbox/repo/src/refund.js\n@@ -11,9 +11,11 @@\n const get = (flag) => {\n   const i = argv.indexOf(flag);\n   return i === -1 ? undefined : argv[i + 1];\n };\n-const id = argv.find((a) => !a.startsWith(\"--\") && argv[argv.indexOf(a) - 1] !== \"--amount\" && argv[argv.indexOf(a) - 1] !== \"--currency\");\n+const id = argv.find(\n+  (a, i) => !a.startsWith(\"--\") && ![\"--amount\", \"--currency\"].includes(argv[i - 1]),\n+);\n \n if (!id) {\n   console.error(\"Usage: npm run refund -- <payment-id> [--amount N --currency XXX]\");\n   process.exit(2);\n","firstChangedLine":15}}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/package.json.","type":"text"}],"details":{"diff":"    ...\n  6   \"description\": \"Minimal dLocal Payins example using the hosted Checkout redirect flow (no dependencies)\",\n  7   \"scripts\": {\n  8     \"checkout\": \"node src/create-checkout.js\",\n  9     \"payment\": \"node src/get-payment.js\",\n+10     \"refund\": \"node src/refund.js\",\n 10     \"sign:demo\": \"node src/dlocal-client.js\"\n 11   },\n 12   \"engines\": {\n 13     \"node\": \">=18\"\n    ...","patch":"--- /sandbox/repo/package.json\n+++ /sandbox/repo/package.json\n@@ -6,8 +6,9 @@\n   \"description\": \"Minimal dLocal Payins example using the hosted Checkout redirect flow (no dependencies)\",\n   \"scripts\": {\n     \"checkout\": \"node src/create-checkout.js\",\n     \"payment\": \"node src/get-payment.js\",\n+    \"refund\": \"node src/refund.js\",\n     \"sign:demo\": \"node src/dlocal-client.js\"\n   },\n   \"engines\": {\n     \"node\": \">=18\"\n","firstChangedLine":10}}

cd /sandbox/repo && grep -q "^.env" .gitignore || printf "\n# Secrets\n.env\n" >> .gitignore; tail -4 .gitignore; echo "=== missing creds"; node src/create-checkout.js; echo "exit=$?"; echo "=== refund usage"; DLOCAL_LOGIN=a DLOCAL_TRANS_KEY=b DLOCAL_SECRET_KEY=c node src/refund.js; echo "exit=$?"

{"content":[{"text":"deps/\n\n# Dart / Flutter\n.dart_tool/\n=== missing creds\nfile:///sandbox/repo/src/dlocal-client.js:20\n    const err = new Error(\n                ^\n\nError: Missing dLocal credentials: DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY.\nCopy .env.example, fill in your sandbox keys from https://dashboard.dlocal.com/settings/integration, then run:\n  export $(grep -v '^#' .env | xargs) && npm run checkout\n    at readCredentials (file:///sandbox/repo/src/dlocal-client.js:20:17)\n    at file:///sandbox/repo/src/create-checkout.js:29:15\n    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)\n    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)\n    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5) {\n  code: 'MISSING_CREDENTIALS'\n}\n\nNode.js v22.23.2\nexit=1\n=== refund usage\nUsage: npm run refund -- <payment-id> [--amount N --currency XXX]\nexit=2\n","type":"text"}]}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/src/create-checkout.js.","type":"text"}],"details":{"diff":"    ...\n 25   return out;\n 26 }\n 27 \n 28 const args = parseArgs(process.argv.slice(2));\n-29 const creds = readCredentials();\n+29 let creds;\n+30 try {\n+31   creds = readCredentials();\n+32 } catch (err) {\n+33   if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n+34   console.error(err.message);\n+35   process.exit(2);\n+36 }\n 30 const client = new DLocalClient(creds);\n 31 \n 32 const payment = {\n 33   amount: Number(args.amount),\n    ...","patch":"--- /sandbox/repo/src/create-checkout.js\n+++ /sandbox/repo/src/create-checkout.js\n@@ -25,9 +25,16 @@\n   return out;\n }\n \n const args = parseArgs(process.argv.slice(2));\n-const creds = readCredentials();\n+let creds;\n+try {\n+  creds = readCredentials();\n+} catch (err) {\n+  if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n+  console.error(err.message);\n+  process.exit(2);\n+}\n const client = new DLocalClient(creds);\n \n const payment = {\n   amount: Number(args.amount),\n","firstChangedLine":29}}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/src/dlocal-client.js.","type":"text"}],"details":{"diff":"     ...\n  34     env: env.DLOCAL_ENV === \"production\" ? \"production\" : \"sandbox\",\n  35   };\n  36 }\n  37 \n+ 38 /** Build a client from env; prints a friendly message and exits if keys are absent. */\n+ 39 export function buildClient(env = process.env) {\n+ 40   try {\n+ 41     return new DLocalClient(readCredentials(env));\n+ 42   } catch (err) {\n+ 43     if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n+ 44     console.error(err.message);\n+ 45     process.exit(2);\n+ 46   }\n+ 47 }\n+ 48 \n  38 export function sign({ login, secretKey, date, body }) {\n  39   const message = `${login}${date}${body ?? \"\"}`;\n  40   return crypto.createHmac(\"sha256\", secretKey).update(message, \"utf8\").digest(\"hex\");\n  41 }\n     ...","patch":"--- /sandbox/repo/src/dlocal-client.js\n+++ /sandbox/repo/src/dlocal-client.js\n@@ -34,8 +34,19 @@\n     env: env.DLOCAL_ENV === \"production\" ? \"production\" : \"sandbox\",\n   };\n }\n \n+/** Build a client from env; prints a friendly message and exits if keys are absent. */\n+export function buildClient(env = process.env) {\n+  try {\n+    return new DLocalClient(readCredentials(env));\n+  } catch (err) {\n+    if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n+    console.error(err.message);\n+    process.exit(2);\n+  }\n+}\n+\n export function sign({ login, secretKey, date, body }) {\n   const message = `${login}${date}${body ?? \"\"}`;\n   return crypto.createHmac(\"sha256\", secretKey).update(message, \"utf8\").digest(\"hex\");\n }\n","firstChangedLine":38}}

{"content":[{"text":"Successfully replaced 2 block(s) in /sandbox/repo/src/create-checkout.js.","type":"text"}],"details":{"diff":"    ...\n  4 //   npm run checkout -- --method CARD      # 1-step checkout straight to the card form\n  5 //   npm run checkout -- --amount 250 --country UY --currency UYU\n  6 //   npm run checkout -- --dry-run          # print the signed request without sending it\n  7 \n- 8 import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+ 8 import { buildClient } from \"./dlocal-client.js\";\n  9 \n 10 function parseArgs(argv) {\n 11   const out = {\n 12     amount: \"120.00\",\n    ...\n 25   return out;\n 26 }\n 27 \n 28 const args = parseArgs(process.argv.slice(2));\n-29 let creds;\n-30 try {\n-31   creds = readCredentials();\n-32 } catch (err) {\n-33   if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n-34   console.error(err.message);\n-35   process.exit(2);\n-36 }\n-37 const client = new DLocalClient(creds);\n+29 const client = buildClient();\n 38 \n 39 const payment = {\n 40   amount: Number(args.amount),\n 41   currency: args.currency,\n    ...","patch":"--- /sandbox/repo/src/create-checkout.js\n+++ /sandbox/repo/src/create-checkout.js\n@@ -4,9 +4,9 @@\n //   npm run checkout -- --method CARD      # 1-step checkout straight to the card form\n //   npm run checkout -- --amount 250 --country UY --currency UYU\n //   npm run checkout -- --dry-run          # print the signed request without sending it\n \n-import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+import { buildClient } from \"./dlocal-client.js\";\n \n function parseArgs(argv) {\n   const out = {\n     amount: \"120.00\",\n@@ -25,17 +25,9 @@\n   return out;\n }\n \n const args = parseArgs(process.argv.slice(2));\n-let creds;\n-try {\n-  creds = readCredentials();\n-} catch (err) {\n-  if (err.code !== \"MISSING_CREDENTIALS\") throw err;\n-  console.error(err.message);\n-  process.exit(2);\n-}\n-const client = new DLocalClient(creds);\n+const client = buildClient();\n \n const payment = {\n   amount: Number(args.amount),\n   currency: args.currency,\n","firstChangedLine":8}}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/src/get-payment.js.","type":"text"}],"details":{"diff":"    ...\n  2 //\n  3 //   npm run payment -- D-4-086e1efe-c391-4226-992f-5e1d8664a297\n  4 //   npm run payment -- D-4-... --status   # lighter /payments/{id}/status endpoint\n  5 \n- 6 import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+ 6 import { buildClient } from \"./dlocal-client.js\";\n  7 \n  8 const argv = process.argv.slice(2);\n- 9 const client = new DLocalClient(readCredentials());\n+ 9 const client = buildClient();\n 10 \n 11 const statusOnly = argv.includes(\"--status\");\n 12 const id = argv.find((a) => !a.startsWith(\"--\"));\n 13 \n    ...","patch":"--- /sandbox/repo/src/get-payment.js\n+++ /sandbox/repo/src/get-payment.js\n@@ -2,12 +2,12 @@\n //\n //   npm run payment -- D-4-086e1efe-c391-4226-992f-5e1d8664a297\n //   npm run payment -- D-4-... --status   # lighter /payments/{id}/status endpoint\n \n-import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+import { buildClient } from \"./dlocal-client.js\";\n \n const argv = process.argv.slice(2);\n-const client = new DLocalClient(readCredentials());\n+const client = buildClient();\n \n const statusOnly = argv.includes(\"--status\");\n const id = argv.find((a) => !a.startsWith(\"--\"));\n \n","firstChangedLine":6}}

{"content":[{"text":"Successfully replaced 1 block(s) in /sandbox/repo/src/refund.js.","type":"text"}],"details":{"diff":"    ...\n  2 //\n  3 //   npm run refund -- D-4-086e1efe-c391-4226-992f-5e1d8664a297\n  4 //   npm run refund -- D-4-... --amount 10 --currency BRL\n  5 \n- 6 import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+ 6 import { buildClient } from \"./dlocal-client.js\";\n  7 \n  8 const argv = process.argv.slice(2);\n- 9 const client = new DLocalClient(readCredentials());\n+ 9 const client = buildClient();\n 10 \n 11 const get = (flag) => {\n 12   const i = argv.indexOf(flag);\n 13   return i === -1 ? undefined : argv[i + 1];\n    ...","patch":"--- /sandbox/repo/src/refund.js\n+++ /sandbox/repo/src/refund.js\n@@ -2,12 +2,12 @@\n //\n //   npm run refund -- D-4-086e1efe-c391-4226-992f-5e1d8664a297\n //   npm run refund -- D-4-... --amount 10 --currency BRL\n \n-import { DLocalClient, readCredentials } from \"./dlocal-client.js\";\n+import { buildClient } from \"./dlocal-client.js\";\n \n const argv = process.argv.slice(2);\n-const client = new DLocalClient(readCredentials());\n+const client = buildClient();\n \n const get = (flag) => {\n   const i = argv.indexOf(flag);\n   return i === -1 ? undefined : argv[i + 1];\n","firstChangedLine":6}}

cd /sandbox/repo && node src/create-checkout.js; echo "exit=$?"; echo "---"; timeout 40 env DLOCAL_LOGIN=t DLOCAL_TRANS_KEY=k DLOCAL_SECRET_KEY=s node src/create-checkout.js --status 200; echo "exit=$?"; echo "---"; timeout 40 env DLOCAL_LOGIN=t DLOCAL_TRANS_KEY=k DLOCAL_SECRET_KEY=s node src/get-payment.js D-4-fake; echo "---"; timeout 40 env DLOCAL_LOGIN=t DLOCAL_TRANS_KEY=k DLOCAL_SECRET_KEY=s node src/refund.js D-4-fake --amount 10 --currency BRL

{"content":[{"text":"Missing dLocal credentials: DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY.\nCopy .env.example, fill in your sandbox keys from https://dashboard.dlocal.com/settings/integration, then run:\n  export $(grep -v '^#' .env | xargs) && npm run checkout\nexit=2\n---\nHTTP 403\n{\n  \"code\": 3001,\n  \"message\": \"Invalid credentials\"\n}\nexit=1\n---\nHTTP 403\n{\n  \"code\": 3001,\n  \"message\": \"Invalid credentials\"\n}\n---\nHTTP 403\n{\n  \"code\": 3001,\n  \"message\": \"Invalid credentials\"\n}\n\n\nCommand exited with code 1","type":"text"}],"details":{}}

{"content":[{"text":"./.env.example\n./.gitignore\n./README.md\n./package.json\n./src/create-checkout.js\n./src/dlocal-client.js\n./src/get-payment.js\n./src/refund.js\n   70 src/create-checkout.js\n  122 src/dlocal-client.js\n   23 src/get-payment.js\n   35 src/refund.js\n  135 README.md\n  385 total\n","type":"text"}]}