/sessions
Cria uma payment session no melhor gateway para o método e a moeda (ou no fixado com gateway) e devolve para onde enviar o cliente.
Autorização
Bearer token: a key de um app, em Apps (sk_app_live_… ou sk_app_test_…), ou a tenant key, em Settings (sk_live_… ou sk_test_…). A key define o modo: uma key live só vê dados live, uma key test só dados de sandbox.
Parâmetros
Qualquer string única por operação (um id de pedido serve). A mesma key devolve o primeiro resultado em vez de criar outro.
Request body
application/json, obrigatório
Positivo, com no máximo 2 casas decimais, ex.: "49.90".
Idioma da página de pagamento e do checkout do gateway. Também aceita pt, en-US e parecidos. Sem ele, vale o Idioma do checkout do app; se não houver, o navegador do cliente.
Para onde o cliente volta, com session_id e um token assinado.
Fixa uma configuração de gateway; sem ele, o roteador escolhe pelo método e pela moeda.
Suas próprias keys, devolvidas como enviadas.
Encontrado pelo external_ref, criado quando é novo; os campos de contato são mantidos atualizados.
O id do usuário no seu sistema.
CPF, CNPJ ou tax id.
Duas letras, ex.: SP.
Duas letras, ex.: BR.
Response body
201Session criada.
A configuração que processa o pagamento.
Envie o cliente para cá para pagar.
true quando a Idempotency-Key já tinha sido usada.
200Mesma Idempotency-Key de uma chamada anterior; a primeira session volta com `duplicate: true`.
A configuração que processa o pagamento.
Envie o cliente para cá para pagar.
true quando a Idempotency-Key já tinha sido usada.
401Secret key ausente ou inválida.
O que deu errado.
422Idempotency-Key ausente, nenhum gateway para o método e a moeda, amount inválido ou registro inválido.
Uma mensagem por campo (idempotency_key, gateway, amount, replaces, subscription ou record).
502O gateway recusou ou falhou a chamada.
A mensagem do gateway.
O provider que falhou.