Saltar para o conteúdo

Easypay Payments API (2.0)

Terms conditions and legal terms
Privacy Policy

Transferir a descrição da OpenAPI
openapi.json
openapi.yaml
Visão geral
Easypay Documentation
correio@easypay.pt
Licença
MIT
Idiomas
Servidores
Sandbox
https://api.test.easypay.pt/2.0
Production
https://api.prod.easypay.pt/2.0

Single Payment

Create and manage one-time payment transactions

Operações

Frequent Payment

Tokenize payment details for variable on-demand charges

Operações

Subscription Payment

Set up and manage automated recurring payments

Operações

Captures

Operations for managing payment captures

Operações

Authorisations

Operations for managing payment authorisations

Operações

Voids

Operations for managing payment voids

Operações

Refunds

Operations for managing payment refunds

Operações

Chargebacks

Operations for managing chargebacks

Operações

Notifications / Webhooks

Configure and manage webhook notifications for payment events

Webhooks

Reports

Access transaction and ledger reports

Operações

Report Ledger

Pedido

The /reports/ledger endpoint provides access to detailed reports of ledger entries within the Easypay reconciliation system. This endpoint retrieves comprehensive financial data for each transaction recorded in the ledger, including captures, refunds, fees, and other financial operations, and it was designed to help users generate precise and relevant financial reports, aiding in effective account reconciliation and financial management.

By using this endpoint, clients can obtain an itemized list of all ledger entries, including relevant financial details such as transaction amounts, fees, taxes, and net transferred amounts. The data returned by this endpoint is ideal for accounting, auditing, and financial analysis purposes, as it ensures transparency and accuracy in financial reporting.

Segurança
accountId and apiKey
Consulta
cursorstring

The cursor parameter is used for pagination. It specifies the pointer to the start of the next set of results in a sequence of paginated data. Typically, this is a unique identifier of the last item from the previous response. If not provided, the API fetches the first page of results.

limitnumber

The maximum number of records to return in a single response. This value determines how many items are included in each page of the results. The default value is 100, and the maximum allowable limit is 100. If not specified, the default limit will be used. Adjust the limit to control the size of the response and manage the data load for each request.

Padrão 100
created_atstring

Filter records by creation datetime interval in UTC. Maximum allowed range is 30 days. Format: interval(YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM).

Exemplo: created_at=interval(2006-01-02 15:04,2006-01-02 15:04)
transaction_typestring

Filter by LedgerTransactionType

Enum"CP""RF""RV""FEE""SP""MAN""TB""OT""CB""OP"
Exemplo: transaction_type=CP
transfer_batchstring

Filter by LedgerTransferBatch

Exemplo: transfer_batch=584
curl -i -X GET \
  'https://api.test.easypay.pt/2.0/report/ledger?cursor=string&limit=100&created_at=interval%282006-01-02+15%3A04%2C2006-01-02+15%3A04%29&transaction_type=CP&transfer_batch=584' \
  -H 'AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6' \
  -H 'ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92'

Respostas

OK

Corpo
metadataobject(metadata-cursor)

An object containing additional information about the response. It includes details that help manage and navigate the retrieved data.

dataArray of objects(LedgerEntry)
Resposta
{
  "metadata": {
    "next_cursor": "lL_j7ilk7rc",
    "count": 10
  },
  "data": [
    { … }
  ]
}

Report Transactions

Pedido

List your transactions

Segurança
accountId and apiKey
Consulta
start_datestring(Y-m-d H:i)

Filter from this date (inclusive). The date and time must be provided in UTC, using the format Y-m-d H:i.

end_datestring(Y-m-d H:i)

Filter until this date (inclusive). The date and time must be provided in UTC, using the format Y-m-d H:i.

pagenumber

Page Number

records_per_pagenumber

Limit records per page (Max: 2500)

Padrão 20
curl -i -X GET \
  'https://api.test.easypay.pt/2.0/report/transactions?start_date=string&end_date=string&page=0&records_per_page=20' \
  -H 'AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6' \
  -H 'ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92'

Respostas

OK

Corpo
metaobject(metadata-page)obrigatório

The Pagination object contains detailed information about the pagination of a collection of records.

This object is used to provide navigation and context for paginated results, allowing users to easily move between pages and understand the scope of the dataset.

meta.​pageobjectobrigatório

An object containing information about the pagination of pages within the collection.

meta.​page.​currentintegerobrigatório

The current page number being viewed.

meta.​page.​totalintegerobrigatório

The total number of pages available in the collection.

meta.​recordsobjectobrigatório

An object containing information about the records within the collection.

meta.​records.​totalintegerobrigatório

The total number of records available in the collection.

meta.​records.​per_pageintegerobrigatório

The number of records displayed per page.

meta.​linksobject

An object containing URLs for navigation between different pages of the collection.

dataArray of objects(transaction-report-data)
Resposta
{
  "meta": {
    "page": { … },
    "records": { … },
    "links": { … }
  },
  "data": [
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Out Payment

Transfer funds from Easypay accounts to SEPA bank accounts

Operações

Config

Configure account URLs for notifications and credit card transactions

Operações

Checkout

Embedded payment form solution for websites

Operações

System

System health check endpoints

Operações
© 2026 easypay - Bank of Portugal N.º 8706