Dados adicionais
Dentro do callback onSubmit existe um segundo parâmetro, de uso opcional, chamado additionalData. Ele é um objeto e pode conter dados adicionais úteis para sua integração, mas que não são necessários para a confirmação do pagamento no backend.
Veja na tabela a seguir os campos contidos dentro do objeto additionalData.
| Campo | Tipo | Descrição |
| bin | string | BIN do cartão inserido pelo usuário. Só é retornado no caso do usuário ter optado pelo pagamento com cartão. |
Veja abaixo um exemplo de uso:
javascript
const settings = {
...,
callbacks: {
onSubmit: (cardFormData, additionalData) => {
// callback chamado o usuário clicar no botão de submissão dos dados
// o parâmetro additionalData é opcional, você pode removê-lo se quiser
console.log(additionalData);
// exemplo de envio dos dados coletados pelo Brick para seu servidor
return new Promise((resolve, reject) => {
fetch("/process_payment", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(cardFormData)
})
.then((response) => {
// receber o resultado do pagamento
resolve();
})
.catch((error) => {
// lidar com a resposta de erro ao tentar criar o pagamento
reject();
})
});
},
},
}Caso não esteja utilizando o botão nativo de enviar formulário do Brick, você também pode acessar o objeto additionalData através do método getAdditionalData. Veja um exemplo de uso a seguir.
javascript
// variável onde o controller do Brick está salvo
cardPaymentBrickController.getAdditionalData()
.then((additionalData) => {
console.log("Additional data:", additionalData);
})
.catch((error) => console.error(error));Atenção
Chame o método
getAdditionalData somente após o envio do formulário, ou seja, após você chamar o método
getFormData.
Com isso, é garantido que os dados retornados são válidos e confiáveis.