Sign in

v1

latestOpenAPI 3.1.0MIT2026-08-0659118508.8 KB
Authorisations

Shows authorisation details

Retrieves the details of an authorisation

Required scope: <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">authorisation:read</code>

get/authorisation/{id}

Path parameters

idstring uuid required

Resource Identification

Response

OK

idstring

A unique identifier for the resource. While typically formatted as a UUID (Universally Unique Identifier), it can also be in other formats as defined by the user. This field ensures the resource can be distinctly recognized and referenced.

status'waiting' | 'pending' | 'failed' | 'canceled' | 'deleted' | 'success'

Indicates the current status of the authorisation. Possible values include:

  • waiting: The payment instruction has been given, but the chosen payment method requires confirmation from an external entity before the status of the operation is finalized.
  • pending: This is the initial state, and it means that the authorisation is queued.
  • success: The authorisation has been completed successfully.
  • failed: The authorisation could not be completed due to an error or issue. This field provides a clear indication of the current state of the authorisation, helping users understand its progress and outcome.
messagestring

A string human-readable message included in the response.

keystring

This can be any string that helps the user uniquely identify or reference the resource in their own system.

currencystring

The currency code in ISO 4217 format (e.g., "EUR" for Euro). This field specifies the type of currency used in financial operation

valuenumber double

The monetary amount requested for the transaction. This field is formatted as a double, and will be rounded to two decimal places.

value_capturednumber double

The monetary amount requested for the capture transaction. This field is formatted as a double, and will be rounded to two decimal places.

Example response

{
  "id": "c6056234-a3f9-42de-b944-3ed793fcb6bb",
  "customer": {
    "id": "649e88cf-0b78-4c36-8f99-33f5ebb812a1",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "911234567",
    "phone_indicative": "+351",
    "fiscal_number": "PT123456789",
    "key": "customer Key Example",
    "language": "PT"
  },
  "method": {
    "url": "https://cc.easypay.pt/v3/public/card-details/cec55ab6-bda3-4ab3-af22-04d2ad2c046a",
    "last_four": "1354"
  },
  "currency": "EUR",
  "value": 125.89,
  "value_captured": 10.87,
  "transactions": [
    {
      "id": "4fb3ac57-c7fe-4157-aeb7-4362ae24deec",
      "key": "Merchant identification key",
      "created_at": "2025-05-30T17:21:46Z",
      "date": "2025-05-30T17:21:47Z",
      "values": {
        "requested": 12.55,
        "paid": 12.55,
        "fixed_fee": 0.07,
        "variable_fee": 0.09,
        "tax": 0.04,
        "transfer": 12.35
      },
      "transfer_date": "2025-06-02T00:00:00Z",
      "method": "mbw",
      "document_number": "MARCEL0208220628294020250530172147",
      "descriptive": "Descriptive Josefa"
    }
  ]
}