E-Wallet
Quick Reference
WhatPagamentos com E-Wallet
WhyPermita que o cliente pague com a carteira digital preferida — um redirecionamento, sem dados de cartão no seu servidor
Reading Time10 min
DifficultyBeginner
PrerequisitesAutenticação → Ambiente
Por que carteiras digitais
| Vantagem | Detalhe |
|---|---|
| Maior conversão | Credenciais salvas — menos campos |
| Sem dados de cartão nos seus servidores | O fluxo por redirecionamento mantém dados sensíveis fora da sua infraestrutura |
| Multimoeda | BRL, CLP, MXN e mais, conforme a carteira |
| Antifraude integrado | O provedor da carteira trata a autenticação do comprador |
Carteiras suportadas
| Carteira | Moedas | Fluxo |
|---|---|---|
| PayPal | BRL, CLP, MXN, USD | Redirecionamento |
| MercadoPago | BRL, ARS, CLP, MXN | Redirecionamento |
Disponibilidade regional
A disponibilidade da carteira depende da configuração do lojista e do país. Confirme com seu gerente de conta antes de ir a produção.
Fluxo de checkout
Criar uma cobrança E-Wallet
- cURL
- Python
- JavaScript
curl -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"wallet_uuid": "00000000-0000-0000-0000-000000000000",
"merchant_id": "11111111-1111-1111-1111-111111111111",
"payer_name": "Ana Martins",
"payer_email": "ana.martins@example.com",
"payer_tax_id": "12345678901",
"payer_cell_phone": "+5511988887777",
"installment_value": 2000,
"installment_count": 1,
"items": [{"name":"Premium Plan","quantity":1,"total_amount":2000,"unit_amount":2000,"sku":"PLAN-001","code":"PP001"}],
"payer_address": {"street":"Av. Apoquindo","address_number":"4500","complement":"","neighborhood":"Las Condes","city":"Santiago","state":"RM","postal_code":"7550000","country":"CL"},
"currency": "CLP",
"due_date": "2026-12-31T23:59:59Z",
"description": "Premium subscription",
"type_charge": "e_wallet",
"reference_external_id": "order-789",
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/success"
}'
import requests
charge = requests.post(
"https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
headers={"Authorization": f"Bearer {access_token}", "Content-Type": "application/json"},
json={
"wallet_uuid": "00000000-0000-0000-0000-000000000000",
"merchant_id": "11111111-1111-1111-1111-111111111111",
"payer_name": "Ana Martins",
"payer_email": "ana.martins@example.com",
"payer_tax_id": "12345678901",
"payer_cell_phone": "+5511988887777",
"installment_value": 2000,
"installment_count": 1,
"items": [{"name": "Premium Plan", "quantity": 1, "total_amount": 2000, "unit_amount": 2000, "sku": "PLAN-001", "code": "PP001"}],
"payer_address": {"street": "Av. Apoquindo", "address_number": "4500", "complement": "", "neighborhood": "Las Condes", "city": "Santiago", "state": "RM", "postal_code": "7550000", "country": "CL"},
"currency": "CLP",
"due_date": "2026-12-31T23:59:59Z",
"description": "Premium subscription",
"type_charge": "e_wallet",
"reference_external_id": "order-789",
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/success",
},
)
payment_url = charge.json()["charge_payment_url"]
const response = await fetch(
"https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
{
method: "POST",
headers: {
Authorization: `Bearer ${accessToken}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
wallet_uuid: "00000000-0000-0000-0000-000000000000",
merchant_id: "11111111-1111-1111-1111-111111111111",
payer_name: "Ana Martins",
payer_email: "ana.martins@example.com",
payer_tax_id: "12345678901",
payer_cell_phone: "+5511988887777",
installment_value: 2000,
installment_count: 1,
items: [{ name: "Premium Plan", quantity: 1, total_amount: 2000, unit_amount: 2000, sku: "PLAN-001", code: "PP001" }],
payer_address: { street: "Av. Apoquindo", address_number: "4500", complement: "", neighborhood: "Las Condes", city: "Santiago", state: "RM", postal_code: "7550000", country: "CL" },
currency: "CLP",
due_date: "2026-12-31T23:59:59Z",
description: "Premium subscription",
type_charge: "e_wallet",
reference_external_id: "order-789",
webhook_url: "https://yoursite.com/webhook",
redirect_url: "https://yoursite.com/success",
}),
}
);
const { charge_payment_url } = await response.json();
Exemplo de webhook
{
"charge_uuid": "22222222-2222-2222-2222-222222222222",
"status": "confirmed",
"transaction_reference": "order-789"
}
Fonte da verdade
Trate webhook_url como fonte da verdade para o status do pagamento. O redirecionamento para redirect_url pode não ocorrer se o pagador fechar a janela da carteira.
Ciclo de vida do status
| Status | Descrição |
|---|---|
issued | URL de redirecionamento pronta |
paid / confirmed | Carteira aprovou |
error | Falhou ou foi recusado |
canceled | Abortado pelo pagador ou pelo sistema |