Skip to main content
POST

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