E-Wallet
Quick Reference
WhatE-Wallet payments
WhyLet customers pay with their preferred digital wallet — one redirect, no card data on your server
Reading Time10 min
DifficultyBeginner
PrerequisitesAuthentication → Environment
Why digital wallets
| Advantage | Detail |
|---|---|
| Higher conversion | Saved credentials — fewer fields |
| No card data on your servers | Redirect flow — A55 handles all sensitive data |
| Multi-currency | BRL, CLP, MXN and more depending on wallet |
| Built-in fraud protection | Wallet provider handles buyer authentication |
Supported wallets
| Wallet | Currencies | Flow |
|---|---|---|
| PayPal | BRL, CLP, MXN, USD | Redirect |
| MercadoPago | BRL, ARS, CLP, MXN | Redirect |
Confirm wallet availability
Wallet availability depends on merchant configuration and country. Confirm with your account manager before going live.
CLP amounts are integers
The example below uses currency: "CLP" with installment_value: 2000. Chilean Peso is a zero-decimal currency — amounts must be whole numbers (no .00). See currency decimal rules.
Checkout flow
Create an E-Wallet charge
- 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();
Webhook example
{
"charge_uuid": "22222222-2222-2222-2222-222222222222",
"status": "confirmed",
"transaction_reference": "order-789"
}
Webhook source of truth
Treat webhook_url as the source of truth for payment status. The redirect to redirect_url may not fire if the payer closes the wallet window.
Status lifecycle
| Status | Description |
|---|---|
issued | Redirect URL ready |
paid / confirmed | Wallet confirmed |
error | Failed or declined |
canceled | Aborted by payer or system |