Pular para o conteúdo

Cancel payment

Cancels one future payment by its payment id. Use this when only a single installment should be removed from a recurrence while leaving other scheduled payments active.

The response body matches Get payment request (RetornoPaymentRequestDto).

PATCH/api/v1/open-integration/payments/{paymentId}/cancel

Cancel a specific payment

Cancels one future payment identified by its payment id.

Auth: Bearer Token

Parâmetros de path

1 campo
paymentId●
pathstring

ID of the payment row to cancel (from `payments[].id` on the payment request).

Corpo da requisição

1 campo
cpfCancelledBy●
bodystring

CPF (digits only) of the person responsible for the cancellation.

curl --request PATCH \
  --url 'https://embedded-payment-manager.hml.linaob.com.br/api/v1/open-integration/payments/pay_abc/cancel' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <SEU_TOKEN>' \
  --data '{
  "cpfCancelledBy": "11111111111"
}'

Response

200Cancellation applied; payment request returned in its updated state.
Response body
object
  • dataobjectrequired

    Payment request details (same shape as Get payment request).

    • idstringrequired

      ID of the payment request.

    • createDateTimestringrequired· date-time

      Creation date and time.

    • lastChangedDateTimestringrequired· date-time

      Last modification date and time.

    • externalCommentstringrequired· nullable

      External comment.

    • externalIdstringrequired· nullable

      External ID.

    • cpfCnpjstringrequired· nullable

      Payer CPF or CNPJ.

    • redirectUristringrequired· nullable

      Redirect URI.

    • tenantIdstringrequired

      Tenant ID.

    • consentIdstringrequired· nullable

      Consent ID.

    • valuenumberrequired

      Total value in BRL.

    • statusstringrequired

      Request-level status. One of `PENDENTE`, `EM_PROCESSAMENTO`, `CONSUMIDO`, `EXPIRADO`, `CANCELADO`, `ERRO_NA_DETENTORA`, `ERRO`.

    • creditorobjectrequired

      Creditor details.

    • debitorobjectrequired· nullable

      Debtor account details or null.

    • typestringrequired· nullable

      One of `NOW`, `SINGLE`, `DAILY`, `WEEKLY`, `MONTHLY`, `CUSTOM`.

    • paymentsarray of objectsrequired

      Payments under this request.

  • messagestring

    Response message.

  • typestring

    Response type.

  • statusCodeinteger· nullable

    HTTP status inside envelope.

Sem exemplo para este status.

Next steps