Atenção!

Esta documentação está em processo de atualização e, por enquanto, representa apenas uma versão preliminar do conteúdo disponível sobre a API. As informações, exemplos e recursos descritos podem evoluir à medida que novas funcionalidades são incorporadas e ajustes técnicos realizados. Recomenda-se consultar este espaço regularmente para acessar as novidades e garantir o uso mais atualizado da integração.

Em caso de dúvidas, nos contate via: [email protected]

A partir do momento em que a API estiver disponível, o processo de obtenção de credenciais acontecerá mediante a criação do usuário e o fornecimento das informações necessárias pelo time Linx Commerce. Todas as instruções e dados de acesso serão enviados diretamente aos parceiros pela equipe responsável, garantindo o controle e a segurança do uso dos serviços.

Status HTTP

📥 Status HTTP

  • 200 OK – Sucesso.

  • 201 Created – Recurso criado.

  • 204 No Content – Operação sem retorno.

  • 400 Bad Request – Dados inválidos.

  • 401 Unauthorized – Token ausente ou inválido.

  • 403 Forbidden – Acesso negado.

  • 404 Not Found – Recurso inexistente.

  • 500 Internal Server Error – Erro interno.


Autenticação

🔒 Autenticação

  • POST {{baseUrl}}/external-payments/v1.0/login


Request Body:

{
  "username": "usuario_exemplo",
  "password": "senha_exemplo"
}

Response 200 OK:

 [
  {
    "providerId": 123,
    "displayName": "Provedor Exemplo",
    "methods": [...],
    "configurationProperties": [...]
  }
]
Estrutura de Endpoints

📂 Estrutura de Endpoints

Provedores de Pagamento:


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


Exemplo de Request Body:

GET {{baseUrl}}/external-payments/v1.0/providers?pageNumber=1&pageSize=10&tenantId=5


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:

[
  {
    "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:

{
  "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:

{
  "providerId": 2,
  "displayName": "Novo Provedor",
  "methods": [...],
  "configurationProperties": [...]
}


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


Exemplo de Request:

GET {{baseUrl}}/external-payments/v1.0/providers/1

Response 200 OK:

{
  "providerId": 1,
  "displayName": "Provedor A",
  "methods": [...],
  "configurationProperties": [...]
}


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


Exemplo de Request:

{
  "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:

{
  "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:

DELETE {{baseUrl}}/external-payments/v1.0/providers/1

Response 200 OK:

{
  "status": "success",
  "message": "Provedor removido com sucesso",
  "providerId": 1
}


Tipos de Pagamento


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


Exemplo de request:

GET {{baseUrl}}/external-payments/v1.0/paymenttypes

Response 200 OK:

[
  "CreditCard",
  "DebitCard",
  "Pix",
  "Boleto"
]

Split de Pagamento

  • Não disponível na V1

Recorrência de pagamento:

  • Não disponível na V1
  • Sem rótulos