Skip to main content
POST
https://api.stylepay.com.br
/
api
/
v1
/
gateway
/
request-qrcode
curl --location 'https://api.stylepay.com.br/api/v1/gateway/request-qrcode' \
--header 'stpi: seu_client_id' \
--header 'stps: seu_client_secret' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 10.50,
  "external_id": "pedido_123",
  "payer": {
    "name": "João Silva",
    "document": "12345678900", # Precisa ser um Documento Valido
    "phoneNumber": "11999999999",
    "email": "joao@email.com",
    "address": {
      "street": "Rua Exemplo",
      "number": "123",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zipCode": "01234567"
    }
  },
  "payerQuestion": "Pagamento do pedido #123",
  "postbackUrl": "https://seusite.com/webhook/pix",
  "products": [
    {
      "name": "Produto 1",
      "quantity": "2",
      "price": 5.25
    }
  ]
}'
{
  "payment_id": "550e8400-e29b-41d4-a716-446655440000",
  "qrcode_image": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "qrcode": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d3-a456-42665544000052040000530398654041.005802BR5913MERCHANT NAME6009SAO PAULO62070503***63041D3D",
  "status": "PENDING"
}

Autenticação

Esta requisição requer autenticação via headers customizados:
stpi
string
required
Seu Client ID
stps
string
required
Seu Client Secret
Content-Type
string
default:"application/json"
required
Tipo do conteúdo da requisição

Corpo da Requisição

amount
number
required
Valor da cobrança em reais (ex: 10.50)
external_id
string
required
Identificador externo do pedido/transação
payer
object
required
Informações do pagador
payerQuestion
string
required
Descrição ou mensagem da cobrança
postbackUrl
string
required
URL para receber notificações de webhook sobre o status do pagamento
products
array
required
Lista de produtos da cobrança

Resposta

payment_id
string
UUID único da transação gerada
qrcode_image
string
Imagem do QR Code em formato Base64
qrcode
string
Código PIX copia e cola (payload do QR Code)
status
string
Status inicial do pagamento (geralmente “PENDING”)
curl --location 'https://api.stylepay.com.br/api/v1/gateway/request-qrcode' \
--header 'stpi: seu_client_id' \
--header 'stps: seu_client_secret' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": 10.50,
  "external_id": "pedido_123",
  "payer": {
    "name": "João Silva",
    "document": "12345678900", # Precisa ser um Documento Valido
    "phoneNumber": "11999999999",
    "email": "joao@email.com",
    "address": {
      "street": "Rua Exemplo",
      "number": "123",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zipCode": "01234567"
    }
  },
  "payerQuestion": "Pagamento do pedido #123",
  "postbackUrl": "https://seusite.com/webhook/pix",
  "products": [
    {
      "name": "Produto 1",
      "quantity": "2",
      "price": 5.25
    }
  ]
}'
{
  "payment_id": "550e8400-e29b-41d4-a716-446655440000",
  "qrcode_image": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "qrcode": "00020126580014br.gov.bcb.pix0136123e4567-e12b-12d3-a456-42665544000052040000530398654041.005802BR5913MERCHANT NAME6009SAO PAULO62070503***63041D3D",
  "status": "PENDING"
}