Skip to main content
POST
/
v1
/
payments
curl --request POST \
  --url https://api.valorapayments.com.br/v1/payments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "payment_method": "pix",
  "amount": 5000,
  "currency": "brl"
}
'
{
  "payment_id": "pay_3f1a8b2c-4d5e",
  "amount": 50,
  "status": "processing",
  "fee_brl": 1.5,
  "net_amount_brl": 48.5,
  "pix": {
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUh...",
    "copia_e_cola": "00020101021226770014br.gov.bcb.pix..."
  },
  "expires_at": "2026-06-26T13:00:00.000Z"
}

Authorizations

​
x-api-key
string
header
required

Chave de API gerada no painel Valora. Envie em todas as requisições.

Body

application/json
​
payment_method
enum<string>
required

Método de pagamento

Available options:
pix,
crypto
​
amount
integer
required

Valor em centavos. Ex: 5000 = R$50,00

Required range: x >= 100
Example:

5000

​
currency
enum<string>
default:BRL

Moeda de cobrança (sempre BRL)

Available options:
BRL
​
metadata
string

JSON serializado com dados extras do seu sistema (ex: order_id, user_id)

Example:

"{\"order_id\": \"ord_123\", \"user_id\": \"usr_456\"}"

​
crypto
object

Obrigatório quando payment_method é crypto

Response

Pagamento criado

​
payment_id
string
Example:

"pay_3f1a8b2c-4d5e"

​
amount
number

Valor bruto em BRL

Example:

50

​
status
enum<string>

processing para PIX (QR gerado), pending para cripto (aguardando pagamento)

Available options:
pending,
processing
​
fee_brl
number

Taxa Valora em BRL

Example:

1.5

​
net_amount_brl
number

Valor líquido creditado na carteira em BRL

Example:

48.5

​
expires_at
string<date-time>
​
pix
object

Presente apenas quando payment_method é pix

​
payment_method
string

Presente apenas quando payment_method é crypto

​
crypto
object

Presente apenas quando payment_method é crypto