Métodos de pagamento

Estes são os métodos que a produção cobra agora: a lista vem da API, e muda quando a Vibra liga ou desliga um gateway (pode demorar até 5 minutos a aparecer aqui). O comprador escolhe no checkout entre os que a sessão aceita. Por omissão são todos os da moeda menos a transferência bancária; com payment_methods escolhes um subconjunto. Esse só aparece quando a sessão o pede por nome em payment_methods (ver mais abaixo).

Por moeda: em AOA, Transferência bancária. Uma sessão que peça um método que não existe na moeda dela (em USD, mcx; em AOA, pix) é recusada com 422 dados_invalidos, e um método sem gateway configurado no modo da chave dá 422 metodo_sem_gateway.

Um pagamento só conta quando o gateway o confirma, e mesmo o aviso do gateway nunca é a última palavra: a API pergunta-lhe pelo estado antes de dar o dinheiro por entrado. Por isso o momento em que recebes payment.succeeded varia com o método:

Pede-se com "payment_methods": ["bank_transfer"] (sozinha ou com outros métodos), numa sessão em AOA. O dinheiro vai direto para a tua conta bancária, e não passa pela Vibra. O comprador vê no checkout:

• o titular, o banco e o IBAN da tua conta. É, por esta ordem, a conta que escolheste para a aplicação da chave que criou a sessão, a tua conta por omissão, ou a conta bancária do KYC (a dos saques). Escolhes as duas primeiras no painel, em Contas de transferência;
• o valor exato, que tem de transferir sem arredondar;
• um descritivo único (TRF seguido de oito carateres, por exemplo TRF7K3QX9AB), que tem de pôr no descritivo da transferência: é por ele que encontras o pagamento no teu extrato;
• a opção de anexar o comprovativo (PDF, JPEG ou PNG, até 10 MB), que tu vês no painel.

O pagamento fica pending até 7 dias, mesmo que a sessão expire antes. Quem o confirma és tu, no painel, em Transferências, ao ver o movimento no teu extrato, com a data e o identificador dele. Nesse momento recebes payment.succeeded com "settlement": "merchant_account". Se recusares (o dinheiro não chegou, ou chegou outro valor), ou se passarem os 7 dias sem decisão, recebes payment.failed com o motivo.

Sem conta nenhuma (nem a do KYC, nem uma acrescentada), a transferência não se oferece, e uma sessão que a peça é recusada com 422 metodo_sem_gateway, a dizer onde a configurar. A comissão de uma plataforma não se aplica à transferência: uma sessão com platform_fee que peça bank_transfer é recusada com 422 comissao_invalida. E a transferência não se estorna pela API (409 pago_na_conta_do_comerciante): a devolução faz-se da tua conta, fora do Vibra Pay, e a taxa não se devolve.

Numa subscrição, a transferência renova por aviso, como a referência: antes de cada ciclo o comprador recebe o link do ciclo, e paga outra vez por transferência para a tua conta.

Uma sessão sem payment_methods não oferece a transferência bancária: demora dias a confirmar, e a maior parte das integrações quer o pagamento no momento. Quem o quer, pede-o por nome. Um método sem gateway configurado dá 422 metodo_sem_gateway, como os outros.

Cada pagamento confirmado escreve o valor bruto, a nossa taxa e o líquido. O evento traz os três (amount, fee, net), e o líquido entra no teu saldo pendente. Passado o prazo de retenção (um dia, salvo acordo diferente), passa a disponível, e é daí que pedes o saque no painel, em produção. A transferência bancária é a exceção: o dinheiro foi direto para a tua conta, nada entra no saldo, e só a taxa sai do disponível ("settlement": "merchant_account").