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

# Push-to-Card Payments

> Push-to-Card payment cards are non-Marqeta cards to which you can disburse funds as an original credit transaction. Before making a disbursement, you must add the card details to the Marqeta platform here.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

<Badge color="yellow">Hidden</Badge>

<Note>
  **Note**\
  This feature is currently in beta and subject to change. It also requires additional activation steps. To learn more about the Beta program for this feature and about activating it for your program, contact your Marqeta representative.
</Note>

The `/pushtocards` endpoint enables you to create a Push-to-Card payment card and disburse funds to it.

A Push-to-Card payment card represents an external (non-Marqeta) card to which you want to disburse funds. You must add the details of this payment card to the Marqeta platform before disbursing funds.

A disbursement draws funds from your Push-to-Card funding reserve balance and sends (or "pushes") the funds to the specified payment card. Each disbursement requires an existing Push-to-Card payment card. A disbursement is not linked to any purchase. This type of disbursement is also known as an original credit transaction (OCT).

You can receive information about Push-to-Card disbursements as they occur by configuring webhooks such as `pushtocard.debit` and `pushtocard.reversal`. Learn about configuring webhooks in the [About Webhooks](/docs/developer-guides/about-webhooks/) guide. See the transaction events for which you can set up webhooks in the [Event Types](/docs/core-api/event-types/) API reference page.

<Note>
  **Note**\
  Marqeta-issued cards and Push-to-Card payment cards are not interchangeable. Marqeta-issued cards are represented by the `card` object and enable users to make payments. Push-to-Card payment cards are represented by the `paymentcard` object and can only receive funds disbursed using the `/pushtocards` endpoint.
</Note>

<h2 id="_create_push_to_card_payment_card">
  Create Push-to-Card payment card
</h2>

**Action:** `POST`\
**Endpoint:** `/pushtocards/paymentcard`

Creates a Push-to-Card payment card. A payment card represents a non-Marqeta card to which you can disburse funds. Each payment card must be associated with an existing user token.

<h3 id="_body_field_details">
  Body field details
</h3>

| Fields                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Optional          | The unique identifier of the payment card.<br /><br />If you do not include a token, the system generates one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                           |
| user\_token<br /><br />string<br /><br />Required    | The payment cardholder’s user token.<br /><br />**Allowable Values:**<br /><br />Existing user token.<br /><br />To obtain a user token, send a `GET` request to the `/users` endpoint.                                                                                                                                                                                                                                                                                                                                          |
| name\_on\_card<br /><br />string<br /><br />Required | The payment cardholder’s name as it appears on the card.<br /><br />**Allowable Values:**<br /><br />50 char max                                                                                                                                                                                                                                                                                                                                                                                                                 |
| pan<br /><br />string<br /><br />Required            | The payment card’s primary account number.<br /><br />**Allowable Values:**<br /><br />19 char max                                                                                                                                                                                                                                                                                                                                                                                                                               |
| cvv<br /><br />string<br /><br />Required            | The three-digit card verification value (CVV2) included on the back of the payment card.<br /><br />**Allowable Values:**<br /><br />3 char max                                                                                                                                                                                                                                                                                                                                                                                  |
| exp\_date<br /><br />string<br /><br />Required      | The payment card’s expiration date.<br /><br />**Allowable Values:**<br /><br />mmyy                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| address\_1<br /><br />string<br /><br />Required     | The payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                               |
| address\_2<br /><br />string<br /><br />Optional     | Additional address information.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| city<br /><br />string<br /><br />Required           | City of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />40 char max                                                                                                                                                                                                                                                                                                                                                                                                                        |
| state<br /><br />string<br /><br />Required          | State of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />2 char max                                                                                                                                                                                                                                                                                                                                                                                                                        |
| postal\_code<br /><br />string<br /><br />Required   | ZIP or postal code of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />10 char max                                                                                                                                                                                                                                                                                                                                                                                                          |
| country<br /><br />string<br /><br />Required        | Country of the payment cardholder’s billing address, expressed as an ISO 3166 code. For example, the numeric code for the United States is `840`, the alpha-2 code is `US`, and the alpha-3 code is `USA`.<br /><br />If you pass the alpha-2 code, the alpha-3 code will be returned in the response.<br /><br />The ISO maintains the <a href="https://www.iso.org/iso-3166-country-codes.html" target="_blank" rel="noopener">full list of ISO 3166 country codes</a>.<br /><br />**Allowable Values:**<br /><br />3 char max |

<h3 id="_sample_request_body">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "user_token": "myUser",
  "name_on_card": "John Smith",
  "pan": "1234123412341234",
  "cvv": "123",
  "exp_date": "0120",
  "address_1": "123 Main Street",
  "city": "Oakland",
  "state": "CA",
  "postal_code":  "94601",
  "country": "USA"
}
```

<h3 id="_sample_response_body">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "created_time": "2021-02-22T18:16:32Z",
  "last_modified_time": "2021-02-22T18:16:36Z",
  "address_1": "123 Main Street",
  "city": "Oakland",
  "state": "CA",
  "postal_code": "94601",
  "country": "USA",
  "last_four": "1234",
  "token": "8fdc41ee-95c5-4a06-83a3-3e6f2537b787",
  "fast_fund_transfer_eligible": true,
  "gambling_fund_transfer_eligible": false,
  "name_on_card": "John Smith"
}
```

<h2 id="_list_push_to_card_payment_cards">
  List Push-to-Card payment cards
</h2>

**Action:** `GET`\
**Endpoint:** `/pushtocards/paymentcard`

Retrieves a list of the existing Push-to-Card payment cards associated with a specific user.

<h3 id="_query_parameters">
  Query parameters
</h3>

| Fields                                            | Description                                                                                                                                                                                   |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user\_token<br /><br />string<br /><br />Required | Identifies the user whose payment cards you want to list.<br /><br />**Allowable Values:**<br /><br />Existing user token.<br /><br />To obtain a user token, send a `GET` request to /users. |

<h3 id="_response_body_details">
  Response body details
</h3>

| Fields                                                                    | Description                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Returned                               | The unique identifier of the payment card.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                         |
| user\_token<br /><br />string<br /><br />Returned                         | The payment cardholder’s user token.<br /><br />**Allowable Values:**<br /><br />Existing user token.                                                                                                                                                                                                                                                      |
| name\_on\_card<br /><br />string<br /><br />Returned                      | The payment cardholder’s name as it appears on the card.<br /><br />**Allowable Values:**<br /><br />50 char max                                                                                                                                                                                                                                           |
| address\_1<br /><br />string<br /><br />Returned                          | The payment cardholder’s street (billing) address.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                |
| address\_2<br /><br />string<br /><br />Returned                          | Additional address information.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                   |
| city<br /><br />string<br /><br />Returned                                | City of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />40 char max                                                                                                                                                                                                                                                  |
| state<br /><br />string<br /><br />Returned                               | State of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />2 char max                                                                                                                                                                                                                                                  |
| postal\_code<br /><br />string<br /><br />Returned                        | ZIP or postal code of the payment cardholder’s billing address.<br /><br />**Allowable Values:**<br /><br />10 char max                                                                                                                                                                                                                                    |
| country<br /><br />string<br /><br />Returned                             | Country of the payment cardholder’s billing address, expressed as an ISO 3166 code. For example, the numeric code for the United States is `840`, the alpha-2 code is `US`, and the alpha-3 code is `USA`.<br /><br />If you passed the alpha-2 code, the alpha-3 code is returned in the response.<br /><br />**Allowable Values:**<br /><br />3 char max |
| last\_four<br /><br />string<br /><br />Returned                          | The last four digits of the payment card number.<br /><br />**Allowable Values:**<br /><br />4 char max                                                                                                                                                                                                                                                    |
| fast\_fund\_transfer\_eligible<br /><br />boolean<br /><br />Returned     | Indicates whether the external payment card issuer supports funding within 30 minutes for this payment card.<br /><br />You must set this flag to `true` for a card to be eligible to receive Push-to-Card payments.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                           |
| gambling\_fund\_transfer\_eligible<br /><br />boolean<br /><br />Returned | Indicates whether the external payment card issuer supports gambling-related funding for this card.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                                                                                                                                            |

<h3 id="_sample_response_body_2">
  Sample response body
</h3>

```json JSON expandable lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "created_time": "2021-02-22T18:16:32Z",
      "last_modified_time": "2021-02-22T18:16:36Z",
      "address_1": "123 Main Street",
      "city": "Oakland",
      "state": "CA",
      "postal_code": "94601",
      "country": "USA",
      "last_four": "1234",
      "token": "8fdc41ee-95c5-4a06-83a3-3e6f2537b787",
      "fast_fund_transfer_eligible": true,
      "gambling_fund_transfer_eligible": false,
      "name_on_card": "John Smith"
    }
  ]
}
```

<h2 id="_retrieve_push_to_card_payment_card">
  Retrieve Push-to-Card payment card
</h2>

**Action:** `GET`\
**Endpoint:** `/pushtocards/paymentcard/{token}`

Retrieves details about a specific Push-to-Card payment card.

<h3 id="_url_path_parameters">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                                                                               |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Identifies the payment card to retrieve.<br /><br />**Allowable Values:**<br /><br />Existing payment card.<br /><br />To obtain a paymentcard token, send a `GET` request to `/pushtocards/paymentcard`. |

<h3 id="_sample_response_body_3">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "created_time": "2021-02-22T18:16:32Z",
  "last_modified_time": "2021-02-22T18:16:36Z",
  "address_1": "123 Main Street",
  "city": "Oakland",
  "state": "CA",
  "postal_code": "94601",
  "country": "USA",
  "last_four": "1234",
  "token": "8fdc41ee-95c5-4a06-83a3-3e6f2537b787",
  "fast_fund_transfer_eligible": true,
  "gambling_fund_transfer_eligible": false,
  "name_on_card": "John Smith"
}
```

<h2 id="_create_push_to_card_disbursement">
  Create Push-to-Card disbursement
</h2>

**Action:** `POST`\
**Endpoint:** `/pushtocards/disburse`

Creates a Push-to-Card disbursement. A Push-to-Card disbursement represents an original credit transaction (OCT), which enables you to draw funds from your Push-to-Card funding reserve balance and send them to an external, non-Marqeta payment card.

<h3 id="_body_field_details_2">
  Body field details
</h3>

| Fields                                                           | Description                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Optional                      | The unique identifier of the disbursement.<br /><br />If you do not include a token, the system generates one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated.<br /><br />**Allowable Values:**<br /><br />36 char max |
| currency\_code<br /><br />string<br /><br />Required             | The three-digit ISO 4217 currency code for the disbursement.<br /><br />**Allowable Values:**<br /><br />3 char max                                                                                                                                                                                                                                                                    |
| amount<br /><br />decimal<br /><br />Required                    | The amount of the disbursement.<br /><br />The maximum amount that you can disburse is determined by your program and/or the recipient financial institution.<br /><br />**Allowable Values:**<br /><br />Format: 0.00 or 0 (including the minor units of currency is optional)                                                                                                        |
| payment\_instrument\_token<br /><br />string<br /><br />Required | The token of the Push-to-Card payment card.<br /><br />**Allowable Values:**<br /><br />Existing Push-to-Card payment card token.                                                                                                                                                                                                                                                      |
| tags<br /><br />string<br /><br />Optional                       | An arbitrary identifier.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                      |
| memo<br /><br />string<br /><br />Optional                       | A message describing the disbursement.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                        |

<h3 id="_sample_request_body_2">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "currency_code": "840",
  "amount": 10.00,
  "payment_instrument_token": "8b2bz20d-7cdc-492b-81z4-77a295z1e471"
}
```

<h3 id="_sample_response_body_4">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "created_time": "2021-02-22T18:17:19Z",
  "last_modified_time": "2021-02-22T18:17:19Z",
  "token": "e50d56cb-9aeb-4a13-a6c4-ed1f089a5ea5",
  "currency_code": "USD",
  "amount": 10.00,
  "status": "success",
  "payment_instrument_token": "8b2bz20d-7cdc-492b-81z4-77a295z1e471"
}
```

<h2 id="_list_push_to_card_disbursements">
  List Push-to-Card disbursements
</h2>

**Action:** `GET`\
**Endpoint:** `/pushtocards/disburse`

Retrieves a list of all the disbursements made to Push-to-Card payment cards.

<h3 id="_sample_response_body_5">
  Sample response body
</h3>

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 1,
  "is_more": false,
   "data": [
    {
      "created_time": "2021-02-22T18:18:58Z",
      "last_modified_time": "2021-02-22T18:18:58Z",
      "token": "4fc83b87-816e-4f67-8819-3a22d912943c",
      "amount": 5.25,
      "status": "success",
      "payment_instrument_token": "8fdc41ee-95c5-4a06-83a3-3e6f2537b787"
    },
    {
      "created_time": "2021-02-22T18:17:19Z",
      "last_modified_time": "2021-02-22T18:17:19Z",
      "token": "e50d56cb-9aeb-4a13-a6c4-ed1f089a5ea5",
      "currency_code": "USD",
      "amount": 10.00,
      "status": "success",
      "payment_instrument_token": "8b2bz20d-7cdc-492b-81z4-77a295z1e471"
     }
  ]
}
```

<h2 id="_retrieve_push_to_card_disbursement">
  Retrieve Push-to-Card disbursement
</h2>

**Action:** `GET`\
**Endpoint:** `/pushtocards/disburse/{token}`

Retrieves the details of a specific Push-to-Card disbursement.

<h3 id="_url_path_parameters_2">
  URL path parameters
</h3>

| Fields                                      | Description                                                                                                                                                                                                   |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token<br /><br />string<br /><br />Required | Identifies the disbursement to retrieve.<br /><br />**Allowable Values:**<br /><br />Existing disbursement token.<br /><br />To obtain a disbursement token, send a `GET` request to `/pushtocards/disburse`. |

<h3 id="_sample_response_body_6">
  Sample response body
</h3>

```json JSON lines wrap theme={null}
{
  "created_time": "2021-02-22T18:17:19Z",
  "last_modified_time": "2021-02-22T18:17:19Z",
  "token": "e50d56cb-9aeb-4a13-a6c4-ed1f089a5ea5",
  "currency_code": "USD",
  "amount": 10.00,
  "status": "success",
  "payment_instrument_token": "8b2bz20d-7cdc-492b-81z4-77a295z1e471"
}
```