Skip to main content
POST
https://api.stylepay.com.br
/
api
/
v1
/
gateway
/
pix-payment
curl --location 'https://api.stylepay.com.br/api/v1/gateway/pix-payment' \
--header 'stpi: seu_client_id' \
--header 'stps: seu_client_secret' \
--header 'Content-Type: application/json' \
--data '{
  "amount": 50.00,
  "description": "Pagamento para fornecedor",
  "creditParty": {
    "name": "Maria Santos",
    "keyType": "CPF",
    "key": "98765432100"
  },
  "callbackUrl": "https://seusite.com/webhook/pix-payment"
}'

{
  "statusCode": 200,
  "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount": 50.00,
  "tax": 1.50,
  "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 do pagamento em reais (ex: 50.00)
​
description
string
required
Descrição ou finalidade do pagamento
​
creditParty
object
required
Informações do beneficiário que receberá o pagamento
​
callbackUrl
string
required
URL para receber notificações de webhook sobre o status do pagamento

​
Resposta

​
statusCode
number
Código de status HTTP da operação
​
transaction_id
string
UUID único da transação de pagamento
​
amount
number
Valor do pagamento realizado
​
tax
number
Taxa cobrada pela transação
​
status
string
Status atual do pagamento. Valores possíveis: PENDING, COMPLETED, FAILED

​
Tipos de Chave PIX

A API aceita os seguintes tipos de chave PIX:
TipoDescriçãoFormato
CPFCadastro de Pessoa Física11 dígitos (somente números)
CNPJCadastro Nacional de Pessoa Jurídica14 dígitos (somente números)
EMAILEndereço de e-mailemail@exemplo.com
PHONENúmero de telefone+5511999999999
EVPChave aleatória (End-to-end)UUID no formato padrão
curl --location 'https://api.stylepay.com.br/api/v1/gateway/pix-payment' \
--header 'stpi: seu_client_id' \
--header 'stps: seu_client_secret' \
--header 'Content-Type: application/json' \
--data '{
  "amount": 50.00,
  "description": "Pagamento para fornecedor",
  "creditParty": {
    "name": "Maria Santos",
    "keyType": "CPF",
    "key": "98765432100"
  },
  "callbackUrl": "https://seusite.com/webhook/pix-payment"
}'

{
  "statusCode": 200,
  "transaction_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "amount": 50.00,
  "tax": 1.50,
  "status": "PENDING"
}

​
Notas Importantes

O pagamento é processado de forma assíncrona. Use a callbackUrl para receber atualizações sobre o status da transação.
Certifique-se de validar a chave PIX do beneficiário antes de enviar o pagamento. Pagamentos enviados para chaves inválidas podem resultar em falhas ou valores não recuperáveis.
A taxa (tax) é calculada automaticamente com base no valor da transação e nas regras da sua conta.