Cartão de débito
Quick Reference
WhatAceitar pagamentos com cartão de débito
WhyMesmo endpoint do crédito — com 3DS obrigatório para autorização segura de débito
Reading Time10 min
DifficultyBeginner
PrerequisitesAutenticação → Cartão de crédito
Débito vs crédito em resumo
| Recurso | Cartão de crédito | Cartão de débito |
|---|---|---|
type_charge | credit_card | debit_card |
| 3DS | Opcional | Obrigatório |
| Parcelamento | Até 12x | Não suportado |
Pré-autorização (capture: false) | Sim | Não |
| Origem dos fundos | Limite de crédito | Saldo bancário |
| Liquidação | Cronograma do adquirente | Em geral mais rápida |
3DS obrigatório
O 3DS é sempre obrigatório para débito. Cobranças sem threeds_authentication: true e device_info válido serão recusadas.
Fluxo da transação
Criar uma cobrança com cartão de débito
- 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": "John Doe",
"payer_email": "johndoe@example.com",
"payer_cell_phone": "+5511999999999",
"payer_tax_id": "9999999999999",
"items": [{"name":"Product","quantity":1,"total_amount":100,"unit_amount":100,"sku":"SKU-001","code":"P001"}],
"payer_address": {"street":"Sample St","address_number":"123","complement":"","neighborhood":"Centro","city":"São Paulo","state":"SP","postal_code":"01000-000","country":"BR"},
"currency": "BRL",
"installment_value": 100,
"installment_count": 1,
"due_date": "2026-12-31",
"description": "Debit purchase",
"type_charge": "debit_card",
"card_name": "John Doe",
"card_number": "4111111111111111",
"card_expiry_month": "12",
"card_expiry_year": "2030",
"card_cvv": "123",
"threeds_authentication": true,
"device_info": {"ip_address":"192.168.0.1","user_agent":"Mozilla/5.0","http_browser_language":"en-US","http_browser_color_depth":"24","http_browser_screen_height":"1080","http_browser_screen_width":"1920"},
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/return"
}'
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": "John Doe",
"payer_email": "johndoe@example.com",
"payer_cell_phone": "+5511999999999",
"payer_tax_id": "9999999999999",
"items": [{"name": "Product", "quantity": 1, "total_amount": 100, "unit_amount": 100, "sku": "SKU-001", "code": "P001"}],
"payer_address": {"street": "Sample St", "address_number": "123", "complement": "", "neighborhood": "Centro", "city": "São Paulo", "state": "SP", "postal_code": "01000-000", "country": "BR"},
"currency": "BRL",
"installment_value": 100,
"installment_count": 1,
"due_date": "2026-12-31",
"description": "Debit purchase",
"type_charge": "debit_card",
"card_name": "John Doe",
"card_number": "4111111111111111",
"card_expiry_month": "12",
"card_expiry_year": "2030",
"card_cvv": "123",
"threeds_authentication": True,
"device_info": {"ip_address": "192.168.0.1", "user_agent": "Mozilla/5.0", "http_browser_language": "en-US", "http_browser_color_depth": "24", "http_browser_screen_height": "1080", "http_browser_screen_width": "1920"},
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/return",
},
)
print(charge.json())
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: "John Doe",
payer_email: "johndoe@example.com",
payer_cell_phone: "+5511999999999",
payer_tax_id: "9999999999999",
items: [{ name: "Product", quantity: 1, total_amount: 100, unit_amount: 100, sku: "SKU-001", code: "P001" }],
payer_address: { street: "Sample St", address_number: "123", complement: "", neighborhood: "Centro", city: "São Paulo", state: "SP", postal_code: "01000-000", country: "BR" },
currency: "BRL",
installment_value: 100,
installment_count: 1,
due_date: "2026-12-31",
description: "Debit purchase",
type_charge: "debit_card",
card_name: "John Doe",
card_number: "4111111111111111",
card_expiry_month: "12",
card_expiry_year: "2030",
card_cvv: "123",
threeds_authentication: true,
device_info: { ip_address: "192.168.0.1", user_agent: "Mozilla/5.0", http_browser_language: "en-US", http_browser_color_depth: "24", http_browser_screen_height: "1080", http_browser_screen_width: "1920" },
webhook_url: "https://yoursite.com/webhook",
redirect_url: "https://yoursite.com/return",
}),
}
);
console.log(await response.json());
Resposta pendente
A resposta costuma retornar status: "pending" com url_3ds. O status final chega via webhook.
Exemplo de resposta
{
"charge_uuid": "51dcca6e-7310-4b73-a94c-90835408f2ff",
"type": "debit_card",
"status": "pending",
"url_3ds": "https://secure.example.com/3ds-challenge?transaction_id=abc123"
}
Ciclo de vida do status
| Status | Significado |
|---|---|
pending | Autenticação 3DS em andamento |
confirmed / paid | Autorizado com sucesso |
error | Recusado ou falha na autenticação |
canceled | Cancelado |
refunded | Estorno processado |