AT-PAYREF-IRC (Autoridade Tributária Referencia de Pagamento IRC)

Retrieve payment references for IRC

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

🚧

What's New in bizAPIs 3.0

Enhanced Error Responses with bizAPIs Status Codes

bizAPIs 3.0 introduces structured error responses with dedicated bizAPIs status codes, making debugging faster and support interactions more efficient. All error responses now include detailed metadata like requestId, errorCode, and errorName to help you quickly identify and resolve issues.

Availability by Environment

EnvironmentStatus
📚 Documentation⏳ Coming Soon
🧪 QUAL⏳ Coming Soon
🚀 Production⏳ Coming Soon

Learn more about error handling →

⚠️

Important Notice

The option to receive the pdf document associated with the extracted information is only available for licenses that include access to this file.
If you wish to enable this feature in your plan, please contact our sales team for further details and subscription options.

JSON Schema for API Response

{
  "type" : "object",
  "properties" : {
    "message" : {
      "type" : "string",
      "description" : "A human-readable message providing additional information about the response, such as error details or informative status updates"
    },
    "data" : {
      "type" : "object",
      "properties" : {
        "requestId" : {
          "type" : "string",
          "description" : "Unique identifier for the request"
        },
        "paymentDocs" : {
          "type" : "array",
          "description" : "List of IRC payment documents",
          "items" : {
            "type" : "object",
            "properties" : {
              "declarationId" : {
                "type" : "string",
                "description" : "Declaration Identification"
              },
              "period" : {
                "type" : "string",
                "description" : "Period of the document"
              },
              "documentId" : {
                "type" : "string",
                "description" : "Unique identifier for the document"
              },
              "fiscalId" : {
                "type" : "string",
                "description" : "Fiscal Identification"
              },
              "amount" : {
                "type" : "number",
                "description" : "Amount to Pay"
              },
              "paymentReference" : {
                "type" : "string",
                "description" : "Payment reference associated with the payment document"
              },
              "paymentCertification" : {
                "type" : "string",
                "description" : "Payment Certification"
              }
            }
          }
        }
      }
    },
    "files" : {
      "type" : "array",
      "description" : "A list of files, each encoded as a Base64 string. Used when multiple files are included in the response.",
      "items" : {
        "type" : "string"
      }
    }
  }
}
{
  "type" : "object",
  "properties" : {
    "message" : {
      "type" : "string",
      "description" : "Mensagem legível para humanos que fornece informações adicionais sobre a resposta, como detalhes de erro ou atualizações informativas de estado"
    },
    "data" : {
      "type" : "object",
      "properties" : {
        "requestId" : {
          "type" : "string",
          "description" : "Identificador único do pedido"
        },
        "paymentDocs" : {
          "type" : "array",
          "description" : "Lista de documentos de pagamento IRC",
          "items" : {
            "type" : "object",
            "properties" : {
              "declarationId" : {
                "type" : "string",
                "description" : "Identificação da declaração"
              },
              "period" : {
                "type" : "string",
                "description" : "Período do documento"
              },
              "documentId" : {
                "type" : "string",
                "description" : "Identificador único do documento"
              },
              "fiscalId" : {
                "type" : "string",
                "description" : "Identificação fiscal"
              },
              "amount" : {
                "type" : "number",
                "description" : "Montante a pagar"
              },
              "paymentReference" : {
                "type" : "string",
                "description" : "Referência de pagamento associada ao documento de pagamento"
              },
              "paymentCertification" : {
                "type" : "string",
                "description" : "Certificação de pagamento"
              }
            }
          }
        }
      }
    },
    "files" : {
      "type" : "array",
      "description" : "Lista de ficheiros, cada um codificado como uma string Base64. Utilizado quando múltiplos ficheiros estão incluídos na resposta.",
      "items" : {
        "type" : "string"
      }
    }

Best Practices

  • Always log the requestId - Include it when contacting support for faster issue resolution
  • Use errorCode or errorName for programmatic error handling in your application
  • Reference the timestamp for correlating errors with your application logs

📖 View complete error codes reference →

Body Params
string
required
Defaults to test

Taxpayer number

string
required
Defaults to test

"Autoridade Tributaria" access password

boolean
Defaults to false

Flag to indicate whether to include the pdf document on the response

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain