Skip to main content
POST
/
organizations
/
{organizationId}
/
invoices
/
{invoiceId}
/
pay
Pagar Fatura
curl --request POST \
  --url https://api.example.com/organizations/{organizationId}/invoices/{invoiceId}/pay \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentMethodId": "<string>"
}
'
{
  "statusCode": 400,
  "message": "Bad Request Error",
  "errors": [{"message": "required", "path": "field"}]
}
Paga uma fatura.
curl -X POST https://api.awsales.io/studio/organizations/ORG_ID/invoices/INVOICE_ID/pay \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "pm_abc123"
  }'
Apenas faturas com status OPEN ou PAYMENT_FAILED podem ser pagas. Tentar pagar uma fatura ja paga ou anulada retornara 409 invoice.not_payable.
Requer permissao invoice:pay.

Cabecalhos

Authorization
string
required
Token bearer.

Parametros de Rota

organizationId
string
required
O UUID da organizacao.
invoiceId
string
required
O UUID da fatura.

Corpo da Requisicao

paymentMethodId
string
ID do metodo de pagamento.

Resposta

invoiceId
string
O UUID da fatura.
organizationId
string
O UUID da organizacao.
subscriptionId
string
O ID da assinatura.
externalRef
string
Referencia externa.
type
string
O tipo da fatura.
paymentMethod
string
O tipo de metodo de pagamento utilizado.
card
object | null
Detalhes do cartao, se o metodo de pagamento for CARD.
boleto
object | null
Detalhes do boleto, se o metodo de pagamento for BOLETO.
currency
string
O codigo da moeda.
totalAmount
integer
Valor total em centavos.
discountAmount
integer
Valor do desconto em centavos.
payableAmount
integer
Valor a pagar em centavos.
discounts
array
Descontos aplicados.
lines
array
Itens da fatura.
billingThreshold
object | null
Configuracao do limiar de cobranca.
status
string
O status da fatura.
issuedAt
string
Timestamp de emissao ISO 8601.
dueDate
string
Data de vencimento ISO 8601.
paidAt
string | null
Timestamp de pagamento ISO 8601.
createdAt
string
Timestamp de criacao ISO 8601.
updatedAt
string
Timestamp da ultima atualizacao ISO 8601.
{
  "statusCode": 400,
  "message": "Bad Request Error",
  "errors": [{"message": "required", "path": "field"}]
}

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
404organization.not_foundOrganizacao nao encontrada
404invoice.not_foundFatura nao encontrada
409invoice.not_payableFatura nao esta em estado pagavel
500internal_server_errorOcorreu um erro inesperado