---
title: "Register pre-created Stripe payment details"
method: POST
path: "/api/v2/organizations/{orgSlug}/payment-details/register"
tags: ["Payment Details"]
---

# Register pre-created Stripe payment details

`POST /api/v2/organizations/{orgSlug}/payment-details/register`

Registers pre-created Stripe customer and payment method details. 

 Required scopes: `flex.billing.paymentDetails.create`

## Path parameters

- `orgSlug` string, required

## Request body

- RegisterPaymentDetailsRequestDto
  - `type` 'stripe', required — The payment provider type. Currently only Stripe is supported.
  - `method` 'card' | 'ach', required — The payment method type. Used to calculate any method-specific processing fees in the summary.
  - `paymentCustomer` string, required — Stripe customer id.
  - `paymentSource` string, required — Stripe payment method id.
  - `isPersonal` boolean, required — Determines whether the card is recorded for the member themselves or for their company.
  - `member` string — The member for which the payment details are recorded.
  - `company` string — The company for which the payment details are recorded.
  - `locations` string — OfficeRnD location ids for multi-location billing.
  - `authorization` PaymentDetailsAuthorizationResultDto
    - `authProvider` string — The id of the auth provider
    - `status` string — The status of the auth
  - `details` union, required — Payment method details (card or ACH).
    - CardDetailsRequestDto
      - `id` string, required — The id of the payment method in Stripe.
      - `last4` string, required — Last 4 digits of the card.
      - `brand` string, required — Brand of the card (e.g., Visa, Mastercard).
      - `expirationMonth` number, required — Expiration month of the card.
      - `expirationYear` number, required — Expiration year of the card.
      - `name` string — The name of the card's owner.
      - `funding` string — The type of card (credit, debit, etc.).
      - `country` string — Country code associated with the card.
      - `cvcCheck` string — Result of the CVC check.
    - AchDetailsRequestDto
      - `id` string, required — The id of the payment method in Stripe.
      - `last4` string, required — Last 4 digits of the bank account.
      - `bankName` string, required — Name of the bank.
      - `accountHolderType` string, required — Type of account holder (individual or company).
      - `accountType` string, required — Type of account (checking or savings).
      - `status` string, required — Status of the bank account.
      - `name` string — The name of the account holder.

## Response `201`

- PaymentDetailsResultDto
  - `_id` string — The _id of the payment details.
  - `details` union — An object containing the payment method details (card or ACH bank account).
    - StripeDetailsResultDto
      - `id` string — The id of the card in Stripe.
      - `name` string — The name of the card's owner.
      - `brand` string — The name of the card's owner.
      - `funding` string — The type of card, e.g. a credit card.
      - `expirationMonth` number — The expiration month of the card.
      - `expirationYear` number — The expiration year of the card.
      - `country` string — The country with which the card is associated.
      - `cvcCheck` string — The result of the CVC check. It should always be set to 'pass', if the card is created.
      - `last4` string — The last 4 digits of the card.
    - AchDetailsResultDto
      - `id` string — The id of the bank account in Stripe.
      - `name` string — The name of the account holder.
      - `last4` string — The last 4 digits of the bank account.
      - `bankName` string — Name of the bank.
      - `accountHolderType` string — Type of account holder (individual or company).
      - `accountType` string — Type of account (checking or savings).
      - `status` string — Status of the bank account.
  - `authorization` PaymentDetailsAuthorizationResultDto
    - `authProvider` string — The id of the auth provider
    - `status` string — The status of the auth
  - `type` 'stripe' — The payment provider type. Currently only Stripe is supported.
  - `method` 'card' | 'ach' — The payment method type. Used to calculate any method-specific processing fees in the summary.
  - `paymentCustomer` string — The _id of the card in Stripe. Same as the _id in the "card" object.
  - `paymentSource` string — The _id of the card in Stripe. Same as the _id in the "card" object.
  - `locations` string — An array containing the list of locations for which the payment details are valid.
  - `createdAt` string, date-time — The time when the payment details were created
  - `createdBy` string — The _id user that created the payment details

---

[API](https://skmtc.dev/officernd/apis/authentication-api.md) · [All operations](https://skmtc.dev/officernd/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/officernd/authentication-api/revisions/6bcd33dc648e/schema)