Skip to main content
POST
/
pixQrCode
/
create
curl --request POST \
  --url https://pay.valora.cash/v1/pixQrCode/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body '{
  "amount": 123,
  "customer": {
    "name": "John Doe",
    "phone": "(11) 000-0000",
    "email": "[email protected]",
    "tax_id": "123.456.789-01"
  },
}'

{ 
	"txid": "42f9c9c4944c4cffb71c4942386690f1",
	"amount": 5.0,
	"status": "Aguardando",
	"method": "PIX",
	"pix_copia_e_cola": "...",
	"constumer": {
		"name": "John Doe",
		"phone": "(11) 000-0000",
		"email": "[email protected]",
		"tax_id": "000.000.00-00"
	},
	"created_at": "2025-30-10T18:56:15.538Z",
	"updated_at": "2025-30-10T18:56:15.538Z",
	"expired_at": "2025-30-10T18:56:15.538Z"
}

​
Authorization

​
Authorization
string
required
Cabeçalho de autenticação Bearer no formato Bearer <api-key> onde <api-key> é a sua chave de API.
curl --request POST \
  --url https://pay.valora.cash/v1/pixQrCode/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --body '{
  "amount": 123,
  "customer": {
    "name": "John Doe",
    "phone": "(11) 000-0000",
    "email": "[email protected]",
    "tax_id": "123.456.789-01"
  },
}'

{ 
	"txid": "42f9c9c4944c4cffb71c4942386690f1",
	"amount": 5.0,
	"status": "Aguardando",
	"method": "PIX",
	"pix_copia_e_cola": "...",
	"constumer": {
		"name": "John Doe",
		"phone": "(11) 000-0000",
		"email": "[email protected]",
		"tax_id": "000.000.00-00"
	},
	"created_at": "2025-30-10T18:56:15.538Z",
	"updated_at": "2025-30-10T18:56:15.538Z",
	"expired_at": "2025-30-10T18:56:15.538Z"
}

​
Body

​
amount
number
required
Valor da cobrança.
​
customer
object
required
Os dados do seu cliente para criá-lo. O objeto de customer é obrigatório, mas ao informar qualquer informação do customer todos os campos name, phone, email e tax_id são obrigatórios.
​
customer.name
string
required
Nome completo do seu clienteExample: "John Doe"
​
customer.phone
string
required
Celular do clienteExample: "(00) 0000-0000"
​
customer.email
string
required
Email do clienteExample: "[email protected]"
​
customer.tax_id
string
required
CPF ou CNPJ do clienteExample: "000.000.000-00"

​
Response

​
response
object
QRCode Pix criado com sucesso
​
txid
string
Identificador único do QRCode Pix.
​
amount
string
Valor a ser pago
​
status
string
Informação sobre o andamento do QRCode Pix.Available options:  Aguardando, Expirado, Cancelado, Paga, Reembolsado
​
method
string
Informação sobre o método do QRCode Pix.Available options:  PIX,
​
pix_copia_e_cola
string
Código copia-e-cola do QRCode Pix.
​
created_at
string
Data de criação do QRCode Pix.
​
updated_at
string
Data de atualização do QRCode Pix.
​
expired_at
string
Data de expiração do QRCode Pix.
​
error
null