---
title: "Create Bank Card Link"
method: POST
path: "/programs/{programCode}/accounts/{accountIdentifier}/disbursements/bankcard"
tags: ["Disbursement"]
---

# Create Bank Card Link

`POST /programs/{programCode}/accounts/{accountIdentifier}/disbursements/bankcard`

Creates a new disbursement link to a bank card for the specified account and program.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Headers

- `X-GD-RequestId` string, required

## Request body

- CreateDisbursementBankCardRequest — Create Disbursement Bank Card Request – Represents the data required to create a bank card disbursement link. Used to securely transmit encrypted bank card information for linking to an account.
  - `encryptedBankCard` EncryptedData — Represents a container for encrypted data used in secure data transfer operations. Contains the encrypted payload and associated cryptographic metadata, including encryption version, ephemeral public key, and public key hash. Used to securely transmit sensitive information such as user data, ensuring confidentiality and integrity during transport.
    - `version` string, nullable — The version of the encryption algorithm used to encrypt the data (e.g., "v1", "v2").
    - `ephemeralPublicKey` string, nullable — The ephemeral public key used in the encryption process, typically for key exchange or session establishment.
    - `publicKeyHash` string, nullable — The hash of the public key used to verify the integrity and authenticity of the encryption key.
    - `data` string, nullable — The encrypted data payload, typically base64-encoded, containing the sensitive information.

## Response `201`

Created

- CreateBankCardResponse — Create Bank Card Response – Contains the result of a bank card link creation operation. Used to confirm the creation and provide details of the linked bank card.
  - `bankcard` DisbursementLink — Disbursement Link – Represents a link or reference to a disbursement resource, such as a bank card, cash, or ACH disbursement. Used to provide details about the disbursement link, including its identifier, URI, status, funds availability, and card association type.
    - `linkId` string, nullable — The unique identifier for the disbursement link.
    - `uri` string, nullable — The URI or resource locator for the disbursement link.
    - `status` string, nullable — The current status of the disbursement link (e.g., "active", "inactive", "pending").
    - `fundsAvailability` string, nullable — The funds availability status or date for the disbursement (e.g., "immediate", "2025-07-23").
    - `cardAssociationType` string, nullable — The card association type for the disbursement link, if applicable (e.g., "Visa", "Mastercard").
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)