Cancelamento de cobranças via API.

POST 
/paymentlink/transaction/:transaction_id/refund

Cancelamento de cobranças via API.

Request

Path Parameters

transaction_id stringrequired

ID da transação

Header Parameters

Authorization stringrequired
Token de autenticação.
Example: Bearer <token>

application/json

Body

required

amount integerrequired

Campo utilizado para o valor do cancelamento em centavos.

Responses

200

Cancelamento criado.

application/json

Schema

Schema

transactionId stringrequired

ID da transação.

amount integerrequired

Valor do cancelamento em centavos.

originalAmount numberrequired

Valor original da transação em centavos.

Example (from schema)

{
  "transactionId": "b9cb5359-c14c-4e4e-b294-ea506ae16778",
  "amount": 1000,
  "originalAmount": 5000
}

Example

{
  "transactionId": "684065d2-6803-40f3-a76c-1108d66d8db0",
  "amount": 1000,
  "originalAmount": 5000
}

400

Erros de integração com outros serviços.

application/json

Schema

Schema

error

object

required

message stringrequired

type stringrequired

code stringrequired

Example (from schema)

{
  "error": {
    "message": "Requisição inválida.",
    "type": "internal",
    "code": "B036"
  }
}

Example

{
  "error": {
    "message": "Requisição inválida.",
    "type": "internal",
    "code": "B036"
  }
}

404

Transação não encontrada.

application/json

Schema

Schema

error

object

required

message stringrequired

code numberrequired

Example (from schema)

{
  "error": {
    "message": "Transação não encontrada.",
    "code": 404
  }
}

Example

{
  "error": {
    "message": "Transação não encontrada.",
    "code": 404
  }
}

422

Erro de validação nos parâmetros enviados.

application/json

Schema

Schema

status integerrequired

Código HTTP do erro.

message stringrequired

Mensagem de erro geral.

errors

object

required

Lista de erros por campo.

amount string[]required

transaction_id string[]required

Example (from schema)

{
  "status": 422,
  "message": "Erro de validação",
  "errors": {
    "amount": [
      "The amount field must be an integer.",
      "The amount field must be greater than zero.",
      "The amount field must be less than 999999999."
    ],
    "transaction_id": [
      "The transaction_id parameter is mandatory.",
      "The transaction_id field must be a uuid."
    ]
  }
}

Example

{
  "status": 422,
  "message": "Erro de validação",
  "errors": {
    "amount": [
      "The amount field must be an integer.",
      "The amount field must be greater than zero.",
      "The amount field must be less than 999999999."
    ],
    "transaction_id": [
      "The transaction_id parameter is mandatory.",
      "The transaction_id field must be a uuid."
    ]
  }
}

500

Erros de integração com outros serviços.

application/json

Schema

Schema

error

object

required

message stringrequired

type stringrequired

code stringrequired

Example (from schema)

{
  "error": {
    "message": "Requisição inválida.",
    "type": "internal",
    "code": "B036"
  }
}

Example

{
  "error": {
    "message": "Erro de comunicação.",
    "type": "internal",
    "code": "B036"
  }
}

Loading...