Additional data
Inside the onSubmit
callback there is a second parameter, of optional use, called additionalData.
It is an object and can contain additional data useful for your integration, but which is not necessary for the commit of payment on the backend.
See the following table for the fields contained within the additionalData
object.
Field | Type | Description |
bin | string | BIN of the card entered by the user. It is only returned if the user has chosen to pay by card. |
See an example of usage below:
const settings = {
...,
callbacks: {
onSubmit: ({ selectedPaymentMethod, formData }, additionalData) => {
// callback called the user to click on the data submit button
// the additionalData parameter is optional, you can remove it if you want
console.log(additionalData);
// example of sending the data collected by Brick to your server
return new Promise((resolve, reject) => {
let url = undefined;
if (selectedPaymentMethod === 'credit_card' || selectedPaymentMethod === 'debit_card') {
url = 'process_payment_card';
} else if (selectedPaymentMethod === 'bank_transfer') {
url = 'process_payment_pix';
} else if (selectedPaymentMethod === 'ticket') {
url = 'process_payment_ticket';
}
if (url) {
fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify(formData),
})
.then((response) => response.json())
.then((response) => {
// receive payment result
resolve();
})
.catch((error) => {
// handle error response when trying to create payment
reject();
})
} else if (selectedPaymentMethod === 'wallet_purchase') {
// wallet_purchase (Mercado Pago Wallet ) doesn`t need to be sent from the backend
resolve();
} else {
reject();
}
});
},
},
}
<Payment
initialization={initialization}
customization={customization}
onSubmit={async ({ selectedPaymentMethod, formData }, additionalData) => {
console.log({ selectedPaymentMethod, formData }, additionalData);
}}
/>
If you are not using the native submit Brick form button, you can also access the additionalData
object via the getAdditionalData
. Check out an example usage below.
javascript
// variable where the Brick controller is saved
paymentBrickController.getAdditionalData()
.then((additionalData) => {
console.log("Additional data:", additionalData);
})
.catch((error) => console.error(error));