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

# Get outbound card payment

> Retrieve a single debit card payment by its ID, from authorization through settlement.

A card payment is one purchase on a [Lemma-issued debit card](https://getlemma.com/docs/api-reference/card-payments.md#issued-debit-cards), including any refunds or reversals. Card payments are separate from [inbound card payments](https://getlemma.com/docs/api-reference/get-inbound-card-payment.md), which Lemma collects on an entity's behalf. To enumerate card payments, see [List outbound card payments](https://getlemma.com/docs/api-reference/list-card-payments.md).

You can read all card payments paid from a bank account you have access to.

## Path parameters

**card\_payment\_id** `string` *required*

The ID of the card payment to retrieve, prefixed with `card_payment_`.

## Response

**id** `string`

Unique identifier for the card payment, prefixed with `card_payment_`.

**created\_at** `string`

[ISO 8601](https://getlemma.com/docs/api-reference/timestamps.md) timestamp of when the card was first
used for this payment.

**account\_id** `string`

The bank account the card spends from.

**card\_id** `string`

The Lemma-issued debit card used for this payment. [Get
card](https://getlemma.com/docs/api-reference/get-card.md) returns the card only if your platform issued
it.

**status** `enum`

Where the payment is in its lifecycle.

**Available options**

**pending** `string`

An authorization is still open, holding funds or awaiting a refund to the
account. Part of the payment may already have posted.

**posted** `string`

Nothing is pending, and at least one element posted a transaction.

**canceled** `string`

The authorization was released or expired before anything posted, so no
money moved.

**declined** `string`

The payment was declined, so no money moved.

**merchant** `object | null`

The merchant the card paid. `null` when the card network did not report the
merchant's name, category code, and country.

**Merchant object**

**name** `string`

The merchant's name as the card network reported it, such as `AMAZON.COM`.

**category\_code** `string`

The merchant category code (MCC), the four-digit code card networks use to
classify a merchant's business.

**country** `string`

The merchant's country, as a two-letter ISO 3166-1 alpha-2 code, such as
`US` or `CA`.

**elements** `object[]`

Everything that happened to this payment, oldest first: its authorization, any
changes to it, and the settlements, refunds, or declines that followed.
Elements in the same second are listed in lifecycle order.

**Element object**

**category** `enum`

What happened. We will add values to this enum over time, so your
application should handle new values gracefully.

**Available options**

**card\_authorization** `string`

The merchant asked to hold funds, or to return them for a refund
authorization.

**card\_increment** `string`

The merchant raised an authorization.

**card\_reversal** `string`

The merchant released some or all of an authorization.

**card\_authorization\_expiration** `string`

An authorization expired before the merchant settled it.

**card\_fuel\_confirmation** `string`

A fuel pump replaced its authorization with the amount actually
pumped.

**card\_settlement** `string`

The merchant settled, and money left the account.

**card\_financial** `string`

The merchant authorized and settled in one step, as at an ATM.

**card\_refund** `string`

The merchant refunded money to the account.

**card\_decline** `string`

The payment was declined.

**created\_at** `string`

[ISO 8601](https://getlemma.com/docs/api-reference/timestamps.md) timestamp of when the card network
event happened, to the second.

**amount** `integer`

How this element changed the account, in cents, signed like a transaction
amount: negative when it holds or takes money from the account, positive
when it releases or returns money. A `card_settlement` of `-4999` posts a
transaction of `-4999`. A `card_decline` carries the amount that would
have moved.

**presentment\_amount** `integer`

This element's `amount` in the currency the merchant charged in, in the
minor unit of `presentment_currency` and signed the same way. When that
currency is not the bank account's, `presentment_amount` differs from
`amount`, which is always in the bank account's currency: a €180.00 charge
has a `presentment_amount` of `-18000` and an `amount` of what it cost in
dollars. When the currencies match, the two are equal. Absent on
`card_authorization_expiration` and `card_fuel_confirmation`, which carry
no presentment amount.

**presentment\_currency** `string`

The three-letter ISO 4217 code of the currency the merchant charged in,
such as `USD` or `EUR`. Present whenever `presentment_amount` is.

**transaction\_id** `string`

The [transaction](https://getlemma.com/docs/api-reference/get-transaction.md) this element posted.
Present on `card_settlement`, `card_financial`, and `card_refund` once the
transaction is recorded, and absent on elements that post nothing.

```json 200 theme={null}
{
  "id": "card_payment_Hq7mTx2nRv5bKw8d",
  "created_at": "2026-10-20T14:02:11Z",
  "account_id": "account_Rv4nBt8xKw2pMh6s",
  "card_id": "card_Bx5nTm8hKw3pVd7c",
  "status": "posted",
  "merchant": {
    "name": "INTERNATIONAL HOTELS",
    "category_code": "7011",
    "country": "US"
  },
  "elements": [
    {
      "category": "card_authorization",
      "created_at": "2026-10-20T14:02:11Z",
      "amount": -10000,
      "presentment_amount": -10000,
      "presentment_currency": "USD"
    },
    {
      "category": "card_increment",
      "created_at": "2026-10-21T09:30:45Z",
      "amount": -2500,
      "presentment_amount": -2500,
      "presentment_currency": "USD"
    },
    {
      "category": "card_settlement",
      "created_at": "2026-10-22T06:15:02Z",
      "amount": -12500,
      "presentment_amount": -12500,
      "presentment_currency": "USD",
      "transaction_id": "transaction_Fh3mPq7xRv2nKt8d"
    }
  ]
}
```

```json 200 (Foreign currency) theme={null}
{
  "id": "card_payment_Wd4nKx8mTq2vRb6p",
  "created_at": "2026-10-14T08:41:37Z",
  "account_id": "account_Rv4nBt8xKw2pMh6s",
  "card_id": "card_Bx5nTm8hKw3pVd7c",
  "status": "posted",
  "merchant": {
    "name": "SUNSHINE MEDICAL",
    "category_code": "5047",
    "country": "FR"
  },
  "elements": [
    {
      "category": "card_authorization",
      "created_at": "2026-10-14T08:41:37Z",
      "amount": -19620,
      "presentment_amount": -18000,
      "presentment_currency": "EUR"
    },
    {
      "category": "card_settlement",
      "created_at": "2026-10-15T05:12:09Z",
      "amount": -19620,
      "presentment_amount": -18000,
      "presentment_currency": "EUR",
      "transaction_id": "transaction_Gt4nRs8yWq3pLm6d"
    }
  ]
}
```

```json 200 (Partially refunded) theme={null}
{
  "id": "card_payment_Np6bVx3kRm9tQd2w",
  "created_at": "2026-10-08T17:20:54Z",
  "account_id": "account_Rv4nBt8xKw2pMh6s",
  "card_id": "card_Bx5nTm8hKw3pVd7c",
  "status": "posted",
  "merchant": {
    "name": "MAPLE SCRUBS",
    "category_code": "5699",
    "country": "US"
  },
  "elements": [
    {
      "category": "card_authorization",
      "created_at": "2026-10-08T17:20:54Z",
      "amount": -8450,
      "presentment_amount": -8450,
      "presentment_currency": "USD"
    },
    {
      "category": "card_settlement",
      "created_at": "2026-10-09T04:03:18Z",
      "amount": -8450,
      "presentment_amount": -8450,
      "presentment_currency": "USD",
      "transaction_id": "transaction_Km2vRt6qCd9wLp4x"
    },
    {
      "category": "card_authorization",
      "created_at": "2026-10-12T11:47:30Z",
      "amount": 2000,
      "presentment_amount": 2000,
      "presentment_currency": "USD"
    },
    {
      "category": "card_refund",
      "created_at": "2026-10-13T04:10:26Z",
      "amount": 2000,
      "presentment_amount": 2000,
      "presentment_currency": "USD",
      "transaction_id": "transaction_Wm9nVx4tRp6bKd2c"
    }
  ]
}
```

```json 404 theme={null}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Card payment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.