---
title: "Create payment details"
method: POST
path: "/v2/payer/{clientUserId}/payment-details"
tags: ["Payer", "V2/Payer"]
---

# Create payment details

`POST /v2/payer/{clientUserId}/payment-details`

Create payment details for a user

## Path parameters

- `clientUserId` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `bankName` string, required — Name of the bank
  - `accountName` string, required — Name of the account holder
  - `accountNumber` string — Bank account number
  - `routingNumber` string — Bank routing number (US)
  - `beneficiaryType` 'individual' | 'business', required — Type of beneficiary
  - `currency` string, required — Three-letter currency code (ISO 4217)
  - `addressLine1` string, required — Primary address line
  - `addressLine2` string — Secondary address line
  - `city` string, required — City name
  - `state` string — State or province code
  - `country` string, required — Two-letter country code (ISO 3166-1 alpha-2)
  - `dateOfBirth` string, required — Date of birth in YYYY-MM-DD format
  - `postalCode` string, required — Postal or ZIP code
  - `rails` 'local' | 'swift' | 'wire' — Payment rail type
  - `sortCode` string — UK bank sort code
  - `iban` string — International Bank Account Number
  - `swiftBic` string — SWIFT/BIC code
  - `documentNumber` string — Government-issued ID number
  - `documentType` string — Type of government-issued ID (e.g., passport, driver's license)
  - `accountType` 'checking' | 'savings' — Type of bank account
  - `ribNumber` string — French RIB number
  - `bsbNumber` string — Australian BSB number
  - `ncc` string — New Zealand NCC number
  - `branchCode` string — Bank branch code
  - `bankCode` string — Bank code
  - `ifsc` string — Indian Financial System Code

## Response `201`

Payment details created successfully

- object
  - `payment_detail` object
    - `id` string
    - `clientUserId` string
    - `bankName` string
    - `accountName` string
    - `currency` string
    - `beneficiaryType` 'individual' | 'business'

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized
- `404` — User not found
- `429` — Too Many Requests

---

[API](https://skmtc.dev/request/apis/request-network-api.md) · [All operations](https://skmtc.dev/request/apis/request-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/request/request-network-api/revisions/042a895ac0c6/schema)