---
title: "Create Payment Method"
method: POST
path: "/user/patient/payment-methods/create"
tags: ["provider", "user", "mfa"]
---

# Create Payment Method

`POST /user/patient/payment-methods/create`

Adds a payment method to a patient.

## Query parameters

- `patient_id` string, required — ID of the patient to add the payment method to

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- RainforestPaymentMethod
  - `paymentMethodId` string, required
  - `paymentMethodConfigId` string, required
  - `fingerprint` string, nullable, required
  - `methodType` string, required
  - `card` RainforestCard, required — The card used to pay for the payin
    - `brand` string, required
    - `last4` string, required
    - `expMonth` integer, required
    - `expYear` integer, required
  - `ach` RainforestACH, required — The ACH used to pay for the payin
    - `accountHolderType` string, required
    - `accountNumberLast4` string, required
    - `bankName` string, required
    - `routingNumber` string, required
  - `applePay` ApplePay, required
    - `type` string, required
    - `brand` string, required
    - `brandDesc` string, required
    - `description` string, required
  - `billingContact` BillingContact, required
    - `name` string, nullable, required
    - `addressLine1` string, nullable, required
    - `addressLine2` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `postalCode` string, nullable, required
    - `country` string, nullable, required
    - `email` string, nullable, required
    - `phone` string, nullable, required
  - `metadata` object, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Response `200`

Successful Response

- PaymentMethodSummary
  - `id` string, required
  - `patientId` string, nullable, required
  - `rainforestPaymentMethodId` string, required
  - `brand` string, nullable, required
  - `last4` string, nullable, required
  - `expMonth` integer, nullable, required
  - `expYear` integer, nullable, required
  - `accountHolderType` string, nullable, required
  - `accountNumberLast4` integer, nullable, required
  - `bankName` string, nullable, required
  - `routingNumber` integer, nullable, required
  - `description` string, nullable, required
  - `type` 'CARD' | 'ACH' | 'APPLE_PAY', required
  - `isDefault` boolean
  - `isArchived` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)