Métodos de Pagamento

Consulte o catálogo público de métodos activos, moedas, tarifa e campos técnicos exigidos. Use esta resposta em cada integração.

GET

/v1/public/payment-methods

Retorna o catálogo dinâmico de métodos de pagamento suportados e parâmetros exigidos.

Cabeçalhos HTTP

Header	Tipo	Presença	Descrição
Accept	string	Recomendado	`application/json`

Nota: O endpoint público não exige chaves de autenticação, permitindo renderização imediata das opções no seu frontend.

GET /v1/public/payment-methods

cURL

curl -X  GET "https://api-pay.edutecka.com/v1/public/payment-methods" \
  -H "X-EDPay-Public-Key: <PUBLIC_KEY>" \
  -H "X-EDPay-Private-Key: <PRIVATE_KEY>" \
  -H "Accept: application/json"

Estrutura dos Campos & Enums do Catálogo

Campo	Tipo	Presença	Valores Permitidos / Enums	Descrição
code	string	Obrigatório	`"method_code"`	Identificador unívoco do método de pagamento.
channel_type	string	Obrigatório	`"card"`, `"wallet"`, `"mobile_money"`	Tipo técnico de processamento do canal.
pricing.percentage_bps	integer	Obrigatório	`600`	Tarifa plana actual: 600 pontos-base (6%) em MZN.
supported_currencies	array[string]	Obrigatório	Lista devolvida para cada método	Moedas ISO suportadas pelo método seleccionado.
required_fields	array[string]	Obrigatório	Campos exigidos no channel	Lista exata de propriedades que devem ser enviadas no payload direto.

Schema JSON da Resposta (JSON Schema Draft-07)

JSON Schema — PaymentMethodsCatalogResponse

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PaymentMethodsCatalogResponse",
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "payment_methods"
      ],
      "properties": {
        "payment_methods": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "code",
              "name",
              "channel_type",
              "enabled",
              "pricing",
              "supported_currencies",
              "required_fields"
            ]
          }
        }
      }
    }
  }
}