POST
/
v1
/
payer
/
{clientUserId}
/
payment-details
Create payment details
curl --request POST \
  --url https://api.request.network/v1/payer/{clientUserId}/payment-details \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "bankName": "Chase",
  "accountName": "Gordon'\''s Chase Business Account",
  "accountNumber": "253009233489",
  "routingNumber": "026013356",
  "beneficiaryType": "business",
  "currency": "usd",
  "addressLine1": "24 Theatre St.",
  "city": "Paramount",
  "state": "CA",
  "postalCode": "90723",
  "country": "US",
  "dateOfBirth": "1985-12-12",
  "rails": "local"
}'
{
  "payment_detail": {
    "id": "pd_123456",
    "clientUserId": "user-123",
    "bankName": "Chase",
    "accountName": "Gordon's Chase Business Account",
    "currency": "usd",
    "beneficiaryType": "business"
  }
}

Headers

x-api-key
string
required

API key for authentication

Path Parameters

clientUserId
string
required

The client user ID

Example:

"user-123"

Body

application/json
bankName
string
required

Name of the bank

Minimum length: 1
accountName
string
required

Name of the account holder

Minimum length: 1
beneficiaryType
enum<string>
required

Type of beneficiary

Available options:
individual,
business
currency
string
required

Three-letter currency code (ISO 4217)

Required string length: 3
addressLine1
string
required

Primary address line

Minimum length: 1
city
string
required

City name

Minimum length: 1
country
string
required

Two-letter country code (ISO 3166-1 alpha-2)

Required string length: 2
dateOfBirth
string
required

Date of birth in YYYY-MM-DD format

postalCode
string
required

Postal or ZIP code

Minimum length: 1
accountNumber
string

Bank account number

routingNumber
string

Bank routing number (US)

addressLine2
string

Secondary address line

state
string

State or province code

rails
enum<string>
default:local

Payment rail type

Available options:
local,
swift,
wire
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
enum<string>

Type of bank account

Available options:
checking,
savings
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

Payment details created successfully

payment_detail
object