Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Painel
borderColor#2C004B
titleColor#FFF
titleBGColor#2C004B
borderStylesolid
titleEstrutura de Endpoints

📂 Estrutura de Endpoints

Imagem geradaImage RemovedProvedores de Pagamento:


  • GET /external-payments/v1.0/providers Lista os provedores de pagamento.


Exemplo de Request Body:

Bloco de código
languagesass
themeMidnight
GET {{baseUrl}}/external-payments/v1.0/providers?pageNumber=1&pageSize=10&tenantId=5


Informações

Parâmetros Query (opcionais):

  • pageNumber: inteiro (número da página)

  • pageSize: inteiro (tamanho da página)

  • tenantId: inteiro (filtra por tenant)


Response 200 OK:

Bloco de código
languagesass
themeMidnight
[
  {
    "providerId": 1,
    "displayName": "Provedor A",
    "methods": [
      {
        "methodId": 10,
        "providerId": 1,
        "paymentTypeId": 101
      }
    ],
    "configurationProperties": [
      {
        "configurationPropertyId": 1001,
        "providerId": 1,
        "name": "ApiKey",
        "displayName": "Chave API",
        "hint": "Chave fornecida pelo provedor",
        "isRequired": true,
        "inputDataType": 1,
        "isSecret": true,
        "configurationOptions": []
      }
    ]
  }
]


  • POST /external-payments/v1.0/providers Cria um novo provedor de pagamento.


Exemplo de Request Body:

Bloco de código
languagesass
themeMidnight
{
  "providerId": 0,
  "displayName": "Novo Provedor",
  "methods": [
    {
      "methodId": 0,
      "providerId": 0,
      "paymentTypeId": 101
    }
  ],
  "configurationProperties": [
    {
      "configurationPropertyId": 0,
      "providerId": 0,
      "name": "ApiKey",
      "displayName": "Chave API",
      "hint": "Chave fornecida pelo provedor",
      "isRequired": true,
      "inputDataType": 1,
      "isSecret": true,
      "configurationOptions": []
    }
  ]
}

Response 201 Created:

Bloco de código
languagesass
themeMidnight
{
  "providerId": 2,
  "displayName": "Novo Provedor",
  "methods": [...],
  "configurationProperties": [...]
}


  • GET /external-payments/v1.0/providers/{id} → Busca um provedor pelo ID


Exemplo de Request:

Bloco de código
languagesass
themeMidnight
GET {{baseUrl}}/external-payments/v1.0/providers/1

Response 200 OK:

Bloco de código
languagesass
themeMidnight
{
  "providerId": 1,
  "displayName": "Provedor A",
  "methods": [...],
  "configurationProperties": [...]
}


  • PUT /external-payments/v1.0/providers/{id} → Atualiza um provedor pelo ID.


Exemplo de Request:

Bloco de código
languagesass
themeMidnight
{
  "providerId": 1,
  "displayName": "Novo Provedor",
  "methods": [
    {
      "methodId": 0,
      "providerId": 0,
      "paymentTypeId": 101
    }
  ],
  "configurationProperties": [
    {
      "configurationPropertyId": 0,
      "providerId": 0,
      "name": "ApiKey",
      "displayName": "Chave API",
      "hint": "Chave fornecida pelo provedor",
      "isRequired": true,
      "inputDataType": 1,
      "isSecret": true,
      "configurationOptions": []
    }
  ]
}

Response 200 OK:

Bloco de código
languagesass
themeMidnight
{
  "providerId": 1,
  "displayName": "Provedor Atualizado",
  "methods": [
    {
      "methodId": 10,
      "providerId": 1,
      "paymentTypeId": 101
    },
    {
      "methodId": 11,
      "providerId": 1,
      "paymentTypeId": 102
    }
  ],
  "configurationProperties": [
    {
      "configurationPropertyId": 1001,
      "providerId": 1,
      "name": "ApiKey",
      "displayName": "Chave API",
      "hint": "Chave fornecida pelo provedor",
      "isRequired": true,
      "inputDataType": 1,
      "isSecret": true,
      "configurationOptions": []
    }
  ]
}


  • DELETE /external-payments/v1.0/providers/{id} → Remove um provedor pelo ID.


Exemplo de Request:

Bloco de código
languagesass
themeMidnight
DELETE {{baseUrl}}/external-payments/v1.0/providers/1

Response 200 OK:

Bloco de código
languagesass
themeMidnight
{
  "status": "success",
  "message": "Provedor removido com sucesso",
  "providerId": 1
}


Imagem geradaImage RemovedTipos de Pagamento


  • GET /external-payments/v1.0/paymenttypes → Recupera os tipos de pagamento disponíveis.


Exemplo de request:

Bloco de código
languagesass
themeMidnight
GET {{baseUrl}}/external-payments/v1.0/paymenttypes

Response 200 OK:

Bloco de código
languagesass
themeMidnight
[
  "CreditCard",
  "DebitCard",
  "Pix",
  "Boleto"
]

Imagem geradaImage RemovedSplit de Pagamento

  • Não disponível na V1

Imagem geradaImage RemovedRecorrência de pagamento:

  • Não disponível na V1

...