Create a PIX or card charge

post

https://dominipay.com/api/wallet/deposit/payment

Creates a charge. method_pay selects the flow:

pix: returns a PIX QR code and copy and paste code in BRL. Live credentials only (sandbox returns 403).
card: returns a hosted checkout_url plus the values needed to embed Apple Pay / Google Pay on your own page. Amount in USD, minimum 5.00. Works with sandbox and live credentials.

For card, the customer fields (debtor_name, email, phone, debtor_document_number) are optional. For PIX, debtor_name, email and phone are required.

This endpoint has no idempotency key. If a request times out, check the transaction before creating a new one.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

token

string

required

Your API token. Live token, or sandbox token (prefix tk_test_) where sandbox is supported.

secret

string

required

Your API secret. Live secret, or sandbox secret (prefix sk_test_) where sandbox is supported.

amount

number

required

Amount in BRL. Minimum and maximum limits are set per platform.

method_pay

string

enum

required

Payment method. Any value that is not a card value is routed to PIX; send pix.

Allowed:

debtor_name

string

required

Payer full name.

string

required

Payer email.

debtor_document_number

string | null

Payer CPF or CNPJ, digits only. Optional in the validation layer, but some PIX acquirers need it, so send it.

phone

string

required

Payer phone, digits only.

postback

string

required

URL that receives the PIX-IN callback when the charge is paid.

Responses

200Charge created.

400Missing credentials: token or secret was not sent.

401Invalid credentials, blocked account, or amount outside the platform deposit limits (BRL values).

403Sandbox credentials on a PIX charge, card payments not enabled for the account (CARD_NOT_AVAILABLE), or account limited to refunds (REFUND_ONLY).

422Validation error, or a card business rule failed (AMOUNT_BELOW_MINIMUM, STRIPE_ACCOUNT_NOT_READY, INVALID_WALLET, or a processor error without error_code). PIX acquirers can also return 422 with their own message.

500Unexpected error, or the PIX acquirer failed.