> ## Documentation Index
> Fetch the complete documentation index at: https://docs.accelebit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/payments/{id} — Retrieve a Payment

> Fetch the current status and full details of a payment by its UUID. Returns amount, currency, provider, status, and error info if the payment failed.

Use this endpoint to fetch the current state of a payment using its UUID. The response includes the full transaction record: status, amount, currency, the upstream provider that processed it, and error details if the payment failed. Payments are scoped to your merchant account — you can only retrieve payments created with your API key.

## Path parameters

<ParamField path="id" type="string" required>
  UUID of the payment to retrieve.
</ParamField>

## Headers

<ParamField header="X-API-Key" type="string" required>
  Your secret API key. Starts with `smtgw_sk_`.
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="id" type="string">
      UUID of the transaction.
    </ResponseField>

    <ResponseField name="merchantId" type="string">
      Your merchant account ID.
    </ResponseField>

    <ResponseField name="customerId" type="string">
      UUID of the Accelebit customer record associated with this payment.
    </ResponseField>

    <ResponseField name="providerId" type="string">
      The upstream provider that processed the payment. `null` if the payment has not yet been submitted to a provider.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current transaction status. One of: `created`, `captured`, `authorized`, `pending_3ds`, `pending_consent`, `failed`.
    </ResponseField>

    <ResponseField name="amount" type="string">
      Payment amount as a decimal string. For example: `"55.00"`.
    </ResponseField>

    <ResponseField name="currency" type="string">
      Three-letter ISO 4217 currency code.
    </ResponseField>

    <ResponseField name="paymentMethod" type="string">
      `"card"` or `"stored_card"`.
    </ResponseField>

    <ResponseField name="merchantRef" type="string">
      Your merchant reference, if you provided one when creating the payment. `null` otherwise.
    </ResponseField>

    <ResponseField name="errorCode" type="string">
      Error code if the payment failed. `null` on success.
    </ResponseField>

    <ResponseField name="errorMessage" type="string">
      Human-readable error message if the payment failed. `null` on success.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of when the payment was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp of the last status update.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.gateway.accelebit.com/v1/payments/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
    -H "X-API-Key: smtgw_sk_test_your_secret_key"
  ```

  ```typescript Node.js theme={null}
  const response = await fetch(
    'https://api.gateway.accelebit.com/v1/payments/f47ac10b-58cc-4372-a567-0e02b2c3d479',
    {
      headers: {
        'X-API-Key': process.env.ACCELEBIT_SECRET_KEY!,
      },
    }
  );

  const result = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.gateway.accelebit.com/v1/payments/f47ac10b-58cc-4372-a567-0e02b2c3d479',
      headers={'X-API-Key': ACCELEBIT_SECRET_KEY},
  )

  result = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "data": {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "merchantId": "merchant_abc123",
      "customerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "providerId": "everest",
      "status": "captured",
      "amount": "55.00",
      "currency": "EUR",
      "paymentMethod": "card",
      "merchantRef": "order_98765",
      "errorCode": null,
      "errorMessage": null,
      "createdAt": "2026-04-09T12:01:00.000Z",
      "updatedAt": "2026-04-09T12:01:02.000Z"
    },
    "meta": {
      "timestamp": "2026-04-09T12:05:00.000Z"
    }
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "data": null,
    "error": {
      "status": 404,
      "name": "NOT_FOUND",
      "message": "Transaction f47ac10b-58cc-4372-a567-0e02b2c3d479 not found"
    }
  }
  ```
</ResponseExample>