Links API DocsLinks API Docs

Retrieve Payment

GET/api/payments/{identifier}

This endpoint retrieves the details of a payment using its unique identifier. The response includes the payment status, amount, and other related details.

Path Parameters

identifierstringrequired

Response

A successful response containing the payment details.

resultobject

The result of the request, including status and any relevant messages.

Show result properties
resultType"Accepted" | "Declined" | "NotFound" | "ValidationFailed" | "Forbidden" | "Error"

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

paymentIdentifierstring

The unique identifier for the payment.

merchantIdentifierstring

The unique identifier for the merchant associated with the payment.

currencyCodestring

The three-letter currency code (ISO 4217) for the payment.

amountnumber<double>

The amount of the payment.

paymentStatus"New" | "Authorized" | "Captured" | "Voided" | "Processing"

The current status of the payment transaction.

customerIdentifierstring

The unique identifier for the customer associated with the payment.

customerReferencestring

A reference provided by the merchant to identify the customer.

merchantOrderIdstring

The unique identifier for the merchant's order.

paymentMethodIdentifierstring

The unique identifier for the payment method used.

statusHistoryobject[]

The history of statuses for the payment transaction.

Show statusHistory properties
status"New" | "Authorized" | "Captured" | "Voided" | "Processing"

The status of the transaction at a specific point in time.

datestring

The date when the transaction reached this status.

acquirerstring

The name of the acquirer processing the payment.

The request is invalid or contains incorrect parameters.

resultobject

The result object that contains the outcome and additional details of the API request.

Show result properties
resultType"Accepted" | "Declined" | "NotFound" | "ValidationFailed" | "Forbidden" | "Error"

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

Unauthorized request. Authentication is required.

Access is forbidden due to insufficient permissions.

The specified payment was not found.

resultobject

The result object that contains the outcome and additional details of the API request.

Show result properties
resultType"Accepted" | "Declined" | "NotFound" | "ValidationFailed" | "Forbidden" | "Error"

The type of result indicating the status of the request.

merchantMessagestring

A message intended for the merchant, providing additional details about the result of the request.

logIdentifierstring

A unique identifier for the server log entry related to this request, useful for troubleshooting.

logAsErrorboolean

Indicates whether this log entry should be treated as an error.

Request
curl -X GET "https://testapi.linksmerchantservices.com/api/payments/<identifier>"
Response
{
  "result": {
    "resultType": "Accepted",
    "merchantMessage": "string",
    "logIdentifier": "string",
    "logAsError": true
  },
  "paymentIdentifier": "string",
  "merchantIdentifier": "string",
  "currencyCode": "string",
  "amount": 0,
  "paymentStatus": "New",
  "customerIdentifier": "string",
  "customerReference": "string",
  "merchantOrderId": "string",
  "paymentMethodIdentifier": "string",
  "statusHistory": [
    {
      "status": "New",
      "date": "string"
    }
  ],
  "acquirer": "string"
}