QR Code Creation

This endpoint enables Dynamic QR Code Generation. These QR Codes require an amount to be set as well as an expiration in seconds and it will respond with a String that should be rendered as a QR Code for the payor to pay from its banking application.

Body Parameters

Name	Type	Description
address	string	Required. Specifies where to deposit the payment in USDt
expire	integer	Required. Expressed in seconds. Note: Cannot exceed 24 hours duration.
amount	float	Required. The amount to charge in BRL. Note: Cannot have more than 2 decimals.
external_reference	string	Optional. In this value you can pass any string that you consider relevant. It can be an internal identification in your system or any other text. The idea is to use it as link in case we need to do some verifications with your database.

Extra Body Parameters

After QR Codes are paid, USDTs will be sent directly to the specified wallet.

You can chose to receive all payments from your specific users/clients to the same wallet of yours and then distribute, or you can chose to send usdt directly to your clients. In case money needs to be distributed to different users, there are some extra body parameters like store, checkout that can be set specifically.

Contact Us for more details on these type of configurations so we can provide you with support on how best to implement depending on your use cae.

By default you should add one address to receive payments to. That address needs to be previously whitelisted with kamiPay to receive payments. Then you can also setup the duration of the QR code and the amount in BRL to be charged to the payor.

Name	Type	Description
store_id	integer	Optional. Store Id corresponds to an internal kamipay mapping to your api_user. Default value is 1 if this key is empty.
checkout_id	integer	Optional. Checkout Id corresponds to an internal kamipay mapping to your api_user. Default value is 1 if this key is empty.
chain	string	Optional. Default value is polygon. In case you are operating with Tron you can add 'tron'.

Example Request

const url = "baseURL/v2/charge/create_dynamic_pix_b2b"
 
const body = {
  address: "0x46d52020**********1fbdcc297d",
  expire: 300,
  amount: 150,
};
 
const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${access_token}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
});

Response

{
  "emv": "b74eb616ab32414aba182b58232e823a5204000053039865802BR592kamiPayInc",
  "operation_id": "1697640236643",
  "amount_brl": 150,
  "amount_usdt": 28.60243,
  "rate": 5.24431,
  "date": 1697640243,
  "expiration": 1697640543
}

Response Details

As a result of this process, you will get two very important inputs:

emv: This is what you will need to render into a QR code, so the payor can scan.
operation_id: This is the tracking number so you can then monitor status of this payment.