Atualizações para março de 2024
Foram feitas algumas atualizações nas mensagens de objeto e resposta de Clientes e Pagamentos. Confira as atualizações abaixo.
- Cliente comercial criado no campo.
- Plano de parcelamento na sessão de checkout.
- URL de retorno para o link de pagamento.
Cliente_comercial_criado_em
Adicionamos um novo objeto ao Cliente e Cliente_pagador objeto chamado merchant_customer_created_at. É um campo que representa a data de registro do cliente na plataforma do comerciante (ISO 8601 MAX 27; MIN 27).
Plano de parcelamento
Adicionamos uma nova matriz de objetos ao Sessão de checkout objeto chamado plan. Permite definir as parcelas a serem mostradas ao cliente na checkout_session. Essa estrutura opcional é usada caso um plano de parcelamento específico precise ser usado na sessão e não haja um plano de parcelamento criado para ele. Se não for enviada, exibiremos o plano de parcelamento criado para a conta para cada cenário, se houver.
| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| parcelas | estrutura | O objeto para enviar o plano de parcelamento criado no Yuno para mostrar aos seus clientes e permitir que eles escolham. Esse campo opcional é usado caso um determinado plano de parcelamento precise ser usado na sessão. Se não for enviado, exibiremos o plano de parcelamento criado para a conta para cada cenário, se houver. | |
| id_plano | string | ID do plano de parcelamento criado no Yuno | 14047811d-5df9-429e-8488-ad41abea1a4b |
| plano | matriz de objetos | Parcelas a serem exibidas ao cliente com a checkout_session. Esse struct opcional é usado caso um determinado plano de parcelas precise ser usado na sessão e não tenha um plano de parcelas criado para ele. Se não for enviado, exibiremos o plano de parcelas criado para a conta em cada cenário, se houver. | |
| parcelamento | int | O número de parcelas mensais que os compradores podem escolher | 3 |
| taxa | flutuar | A taxa que será aplicada ao valor final da transação pelo provedor de pagamento após o uso de parcelas. Expressa em porcentagem. | 1.5 |
Ambos installments.plan_id e installments.plan são estruturas opcionais e, se definidas, apenas uma delas deve ser usada ao mesmo tempo.
URL de retorno de chamada
Adicionamos um novo campo ao campo Link para pagamento objeto chamado callback_urlAo criar o link de pagamento, este campo permite definir o URL para o qual devemos redirecionar o seu cliente após efetuar o pagamento (MÁX. 255; MÍN. 23).