Envia uma sessão de checkout para pagamento (assíncrono)
POST
/v1/checkouts/sessions/{sessionId}/payAutentique com o header SelectKey: a chave sk_test_ opera no sandbox, a sk_live_ em produção. Como autenticar.
Parâmetros do caminho
sessionIdstringobrigatórioIdentificador público (sess_/ckts_/ses_…)
Corpo da requisição
paymentobjectobrigatórioA escolha do pagamento; o carrinho e o comprador vêm da sessão.
+4 campos de
paymentcardIdstringO cartão salvo a cobrar; obrigatório para
credit.methodstringobrigatórioMétodo de pagamento:
credit,pixoubillet.Valores:creditpixbilletcapturebooleanSe a cobrança no cartão é capturada na hora (
true) ou só autorizada (false).installmentsintegerNúmero de parcelas (1–21); o máximo oferecido é o configurado para a conta.
Respostas
202Aceito
jobIdstringobrigatórioIdentificador público (payjob_…)
statusstringobrigatórioEstado do processamento do pagamento:
pending,processing,requiresAction,completedoufailed.Valores:pendingprocessingrequiresActioncompletedfailedsessionIdstringobrigatórioIdentificador público (sess_/ckts_/ses_…)
400Requisição inválida (validação)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
401Não autenticado (credencial ausente ou inválida)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
403Sem permissão
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
404Não encontrado
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
409Conflito (idempotência ou estado)
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório
500Erro interno do servidor
errorobjectobrigatório+8 campos de
errorcodestringobrigatórioparamsobject[]statusstringobrigatóriodetailsstringmessagestringobrigatóriocategorystringobrigatórioValores:validationauthenticationauthorizationpaymentclientserverrate_limitpendingresourcestringobrigatóriostatusCodeintegerobrigatório