✅ Habilitar métodos de pagamento via API
O que você vai aprender com este artigo?
- Métodos de pagamento disponíveis na iugu e suas características
- Passo a passo para habilitar métodos de pagamento via painel ou API
- Configurações avançadas para cada método, incluindo parâmetros específicos
- Bandeiras de cartão de crédito aceitas e restrições importantes
Quais são os métodos disponíveis na iugu?
Aceitamos 3 métodos:
- Cartão de Crédito
- Boleto Bancário e
- Pix
Bandeiras suportadas
As bandeiras que a iugu suporta são:
- American Express
- Diners
- Elo
- MasterCard
- Visa
Como habilitar métodos de pagamento?
Há duas formas para isso:
- Via Painel
- Via API
Painel — passo a passo
- Acesse alia.iugu.com
- Configurações > na seção Recebimento escolha o método desejado
- Marque a caixa de seleção "Ativo"
API
Para cada método utilize os endpoints e seus respectivos parâmetros listados abaixo:
| Método | Endpoint | Objeto | Parâmetro | Informar |
|---|---|---|---|---|
| Boleto Bancário | Configurar Conta — v1/accounts/configuration | bank_slip | active | true |
| Cartão de Crédito | Configurar Conta — v1/accounts/configuration | credit_card | active | true |
| Pix | Configurar Pagamentos Pix — v1/payments/pix | N/A | enable | true |
Chave EVP
A primeira ativação do método Pix criará uma chave EVP no Banco Central
Recursos de cada método
Cada método de pagamento conta com suas próprias características e recursos. Saiba como configurar cada um desses recursos.
Cartão de Crédito
No endpoint Configurar Conta — v1/accounts/configuration, com o método credit_card ativado, é possível ativar os seguintes recursos
| Parâmetro | Descrição |
|---|---|
soft_descriptor* | Descrição quer aparecerá na Fatura. Limitação de 12 a 22 caracteres (a depender da adquirente) |
installments | Parcelas |
max_installments | Número máximo de parcelas (1 a 12x) |
max_installments_without_interest | Número máximo de parcelas sem juros |
two_step_transaction | Transação em Duas Etapas |
installments_pass_interest* | Repasse de Juros de Parcelamento |
Importantes
installments_pass_interest: disponível para contas antigassoft_descriptor: não é permitido utilizar caracteres especiais
Boleto Bancário
No endpoint Configurar Conta — v1/accounts/configuration, com o método bank_slip ativado, é possível ativar os seguintes recursos
| Descrição | Parâmetro |
|---|---|
| Dias de Vencimento Extras | extra_due |
| 2ª Via — Dias de Vencimento Extras | reprint_extra_due |
Updated 3 months ago