Checkout e formas de pagamento

O link Saiba mais aparece em

Conta, Configurações, Checkout de pagamentos,

abaixo das formas de pagamento padrão.

Consultar essa seção exige Ver configurações da conta. Editar aparência do checkout e Editar formas de pagamento controlam suas respectivas alterações. As opções também dependem da disponibilidade da conta.

Formas de pagamento

Os meios habilitados nessa seção formam o padrão da conta. O checkout usa esse padrão quando a cobrança e o link não têm uma configuração própria de meios de pagamento. Alterar o padrão também muda as opções dessas cobranças.

Cobranças criadas por integração

A requisição Criar nova cobrança aceita uma lista própria em payment_method_types: [1] para Pix, [2] para boleto ou [1, 2] para ambos. Essa lista substitui o padrão da conta somente na cobrança, respeitando a disponibilidade da plataforma. Uma configuração própria do link pode reduzir suas opções.

Omitir a lista ou enviar null preserva a herança da configuração usada pelo checkout. Sem lista própria, payment_method: 0 deixa o pagador escolher, enquanto 1 ou 2 restringe a cobrança ao meio indicado. Com a lista preenchida, omita payment_method ou envie 0. Nenhuma dessas opções altera o padrão da conta.

Sem lista própria, payment_method: 1 solicita Pix e payment_method: 2 solicita boleto na criação, com os dados disponíveis para o integrador apresentar ao pagador. O boleto usa o cadastro do cliente e pode completar campos de endereço ausentes pelo CEP. Uma lista como payment_method_types: [1] ou [2] mantém a emissão após a escolha no checkout. Veja Receber o Pix na criação e Receber o boleto na criação.

Consulte Meios de pagamento para conferir os códigos e a diferença entre o meio cadastrado e a escolha do checkout.

Para entender o cadastro do cliente, o valor, o vencimento e o envio opcional do link por e-mail, consulte Cobranças.

Use create_checkout: true na criação da cobrança para receber seu link em checkout_url, mesmo sem envio de e-mail ou URL de retorno. O link pertence àquela cobrança. Para obter ou configurar o link de uma cobrança existente, consulte Links de pagamento.

O vencimento deve estar pelo menos cinco minutos à frente do horário atual quando a API validar a requisição. O Pix conserva o horário informado; o boleto usa a data de São Paulo, inclusive o mesmo dia. Um checkout expirado não confirma o cancelamento de um boleto já emitido.

Alterar o padrão

Cartão pode aparecer como Indisponível. Um método mostrado na interface não deve ser considerado habilitado para a operação quando o controle estiver bloqueado.

Alterar a aparência

1. Acesse Conta, Configurações, Checkout de pagamentos, Aparência com Editar aparência do checkout.
2. Use Enviar logo e Enviar ícone para os arquivos da marca. Respeite os formatos, dimensões e tamanho mostrados e aguarde o envio terminar.
3. Informe E-mail de suporte ao cliente se quiser indicar um contato da sua empresa no checkout.
4. Ajuste Cor principal e Cor de fundo em formato hexadecimal. Use Restaurar cores padrão se quiser voltar à paleta original.
5. Confira a Prévia do checkout no modo de celular ou desktop e selecione Salvar identidade.

A prévia permite revisar a aparência; ela não cria nem paga uma cobrança. As alterações só devem ser consideradas salvas depois da confirmação.

Orientar quem recebeu um link

O pagador abre o link compartilhado pela empresa e confere os dados da cobrança e os métodos disponíveis. Para Pix, segue o QR Code ou código de pagamento mostrado; para boleto, usa o documento ou a linha de pagamento disponibilizada. A confirmação depende do estado mostrado no checkout e na cobrança.

Quando o link tem uma URL de cancelamento HTTPS válida e aceita pela Raims, o checkout mostra a seta Voltar ao site ao lado da marca. Selecionar essa seta abre o endereço configurado pela empresa. Ela não cancela a cobrança, o Pix ou o boleto e não confirma um pagamento.

Sem um endereço de retorno válido, a seta não aparece. Fechar a aba não executa esse retorno automaticamente. A seta pertence às etapas de preenchimento e pagamento do checkout; ela não aparece no recibo nem em um link inválido.

Com uma URL de sucesso HTTPS válida e aceita pela Raims, o checkout pode tentar abrir automaticamente esse endereço quando receber a confirmação de que a cobrança foi paga. Essa tentativa exige que a mesma abertura já estivesse acompanhando o pagamento antes da confirmação e continue válida para esse acompanhamento.

A Raims autoriza no máximo uma tentativa automática por cobrança, mesmo que ela esteja aberta em várias abas ou dispositivos. Recarregar ou reabrir uma cobrança já paga e consultar diretamente a fatura ou o recibo não iniciam nem repetem esse retorno. Se o pagador escolher Voltar ao site, consultar a fatura ou o recibo enquanto aguarda o retorno, a navegação automática não é retomada.

Gerar um Pix, emitir um boleto ou mostrar um pagamento em processamento não confirma que a cobrança foi paga. Falha, cancelamento e devolução também não acionam esse retorno. Sem URL de sucesso válida, o checkout não usa a URL de cancelamento como destino automático.

A tentativa de retorno não garante a chegada ao site: fechar a aba ou perder a conexão pode interromper a navegação. Use o estado confirmado da cobrança para conferir o pagamento; uma visita à URL de sucesso não substitui essa confirmação.

Um link de Sandbox indica teste e não deve ser apresentado como pagamento real. Se o checkout informar link não encontrado ou indisponível, confira se abriu o endereço completo enviado pela empresa, sem alterar nenhuma parte. Se o aviso continuar, peça à empresa que emitiu a cobrança para conferir o link. A mensagem não informa o motivo da indisponibilidade e não permite concluir se o link foi pausado, se a cobrança foi cancelada ou se houve pagamento.