Skip to main content
POST
Initiate a payment

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Organization-Id
string

Tenant organization ID. Accepted but ignored: the tenant is determined by the credentials you authenticate with, so sending this header, or sending a different value in it, changes nothing.

Idempotency-Key
string

Client-supplied idempotency key. Required in practice even though the schema marks it optional: a request that omits this header is refused with 400 PBP-0012.

Cuerpo

application/json
digitableLine
string
requerido

Bankslip or utilities digitable line, digits only.

Ejemplo:

"00190500954014481606906809350314337370000000100"

midazAccountId
string
requerido

Midaz account the payment settles from.

payer
object
requerido

Who pays this slip. Required by the provider contract.

description
string

Free-text description carried on the payment.

payeeName
string

Recipient name. Optional: may be omitted, and an empty value is treated exactly like omitting it.

payeeTaxId
string

Recipient CPF or CNPJ, digits only. Optional: may be omitted, and an empty value is treated exactly like omitting it.

Respuesta

Created

amount
string
requerido
createdAt
string
requerido
digitableLine
string
requerido
id
string
requerido
providerId
string
requerido
status
string
requerido
type
string
requerido
dueDate
string