Métodos de Pagamento
O campo payment_method_kind define como a conta a pagar será (ou foi) quitada. O método determina quais campos adicionais ficam disponíveis no formulário.
Métodos Disponíveis
| Método | Código | Campos extras |
|---|---|---|
| Boleto bancário | bank_billet | Código de barras (barcode) |
| PIX | pix | Pix Copia e Cola (pix_copia_e_cola), chave PIX (pix_key, pix_key_type) |
| TED / DOC | ted | Banco, agência, conta e dígitos do favorecido |
| Conta de consumo | utility | Código de barras da concessionária |
| Tributo | tribute | Tipo de tributo (tax_kind) + campos específicos da guia |
| Débito automático | direct_debit | — |
| Cartão de crédito | credit_card | — |
| Cartão de débito | debit_card | — |
| Dinheiro | cash | — |
| Cheque | check | — |
| Outro | other | — |
PIX — Tipos de Chave
Tipo (pix_key_type) | Formato |
|---|---|
cpf | 11 dígitos |
cnpj | 14 dígitos |
email | Endereço de e-mail |
phone | Número de telefone com DDD |
random | Chave aleatória (UUID) |
O campo pix_copia_e_cola aceita o payload completo do PIX. O sistema decodifica automaticamente os dados do favorecido e preenche os campos restantes.
TED — Coordenadas Bancárias
Para pagamentos via TED, preencha:
- Banco — código COMPE (3 dígitos) ou ISPB (8 dígitos)
- Agência e dígito da agência
- Conta e dígito da conta
- Finalidade da transferência (
transfer_purpose)
Operação Kobana
O campo operation_kind controla como o pagamento é enviado via Gateway Bancário:
| Valor | Rota Kobana |
|---|---|
payment | Pagamento de documento (boleto, tributo, conta de consumo, PIX pagar) |
transfer | Transferência para favorecido (TED, PIX transferência) |
Quando operation_kind é nulo, o pagamento não é enviado pelo Kobana (ex.: dinheiro, cartão).