Skip to main content
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": "johndoe@valorapay.cash",
    "tax_id": "123.456.789-01"
  },
}'
{ 
	"txid": "42f9c9c4944c4cffb71c4942386690f1",
	"amount": 5.0,
	"status": "Aguardando",
	"method": "PIX",
	"pix_copia_e_cola": "...",
	"pix_qr_code_image": "...",
	"constumer": {
		"name": "John Doe",
		"phone": "(11) 000-0000",
		"email": "johndoe@valorapay.cash",
		"tax_id": "000.000.00-00"
	},
	"created_at": "2025-30-10T18:56:15.538Z",
	"updated_at": "2025-30-10T18:56:15.538Z",
	"expires_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": "johndoe@valorapay.cash",
    "tax_id": "123.456.789-01"
  },
}'
{ 
	"txid": "42f9c9c4944c4cffb71c4942386690f1",
	"amount": 5.0,
	"status": "Aguardando",
	"method": "PIX",
	"pix_copia_e_cola": "...",
	"pix_qr_code_image": "...",
	"constumer": {
		"name": "John Doe",
		"phone": "(11) 000-0000",
		"email": "johndoe@valorapay.cash",
		"tax_id": "000.000.00-00"
	},
	"created_at": "2025-30-10T18:56:15.538Z",
	"updated_at": "2025-30-10T18:56:15.538Z",
	"expires_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: "johndoe@valoracash.pay"
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.
pix_qr_code_image
string
Imagem em Base64 do QRCode Pix.
created_at
string
Data de criação do QRCode Pix.
updated_at
string
Data de atualização do QRCode Pix.
expires_at
string
Data de expiração do QRCode Pix.
error
null