POST
/
accounts
/
{acc_id}
/
payment_instruments
curl https://production.methodfi.com/accounts/acc_4m9amk4KFiaQX/payment_instruments \
-X POST \
-H "Method-Version: 2024-04-04" \
-H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
-H "Content-Type: application/json" \
-d '{
  "type": "card"
}'
{
  "success": true,
  "data": {
    "id": "pmt_inst_pd788hPVhLT37",
    "account_id": "acc_GAzrD99cUqGEN",
    "type": "card",
    "card": {
      "number": "5555555555551580",
      "exp_month": "04",
      "exp_year": "2027"
    },
    "network_token": null,
    "chargeable": true,
    "status": "completed",
    "error": null,
    "created_at": "2025-04-03T19:30:56.039Z",
    "updated_at": "2025-04-03T19:30:56.039Z"
  },
  "message": null
}

Enables creation of a PaymentInstrument linked to an account, returning card credentials (e.g., card number, expiration, or network token) that can be used to facilitate checkout.

Operation Type:

Path Parameters

acc_id
string
required

The ID of the Account.

Request Body Parameters

type
enum
required

The type of payment instrument to create.

Returns

Returns a PaymentInstrument object.

curl https://production.methodfi.com/accounts/acc_4m9amk4KFiaQX/payment_instruments \
-X POST \
-H "Method-Version: 2024-04-04" \
-H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
-H "Content-Type: application/json" \
-d '{
  "type": "card"
}'
{
  "success": true,
  "data": {
    "id": "pmt_inst_pd788hPVhLT37",
    "account_id": "acc_GAzrD99cUqGEN",
    "type": "card",
    "card": {
      "number": "5555555555551580",
      "exp_month": "04",
      "exp_year": "2027"
    },
    "network_token": null,
    "chargeable": true,
    "status": "completed",
    "error": null,
    "created_at": "2025-04-03T19:30:56.039Z",
    "updated_at": "2025-04-03T19:30:56.039Z"
  },
  "message": null
}