Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-08-06177398877.4 KB
Vendor Payment Methods

Create vendor payment method

Create a new vendor payment method.

Important: The vendorId cannot be changed after creation.

post/vendor-payment-methods

Request body

vendorIdstring uuid required

Vendor profile ID.

IMPORTANT: This field cannot be changed after creation.

paymentMethodType'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK' required

Payment method type

statusstring

Payment method status

isPreferredboolean

Whether this is the preferred payment method

emailstring email

Email address for payment notifications

phonestring

Phone number for payment contact

companyNamestring

Company name for this payment method

usernamestring

Username for payment platforms

bankNamestring

Bank name

bankAddressstring

Bank address

accountNamestring

Bank account holder name

accountNumberstring

Bank account number

abaAchstring

ABA/ACH routing number

wirestring

Wire transfer routing number

swiftCodestring

SWIFT/BIC code for international transfers

eftInstitutionstring

EFT institution number (Canadian banking)

eftTransitstring

EFT transit number (Canadian banking)

clabestring

CLABE number (Mexican banking)

currencystring

Preferred currency code (ISO 4217)

paymentTermIdstring uuid

Payment term ID

Example request

{
  "vendorId": "770e8400-e29b-41d4-a716-446655440000",
  "paymentMethodType": "ACH",
  "status": "ACTIVE",
  "isPreferred": true,
  "email": "payments@vendor.com",
  "phone": "+1-555-123-4567",
  "companyName": "Vendor Payments LLC",
  "username": "vendor_payments",
  "bankName": "Chase Bank",
  "bankAddress": "123 Bank Street, Dallas, TX 75201",
  "accountName": "Vendor Services Inc",
  "accountNumber": "1234567890",
  "abaAch": "021000021",
  "wire": "026009593",
  "swiftCode": "CHASUS33",
  "eftInstitution": "001",
  "eftTransit": "00010",
  "clabe": "012180001234567897",
  "currency": "USD",
  "paymentTermId": "550e8400-e29b-41d4-a716-446655440002"
}

Response

Vendor payment method created successfully

idstring uuid required

Unique vendor payment method identifier

vendorIdstring uuid required

Vendor profile ID (read-only after creation).

This field cannot be changed after the payment method is created.

paymentMethodType'ACH_WIRE' | 'ZELLE' | 'VENMO' | 'ACH' | 'CHECK' | 'WIRE' | 'CAD_EFT' | 'TRIUMPH_PAY' | 'COMCHECK' | 'EFS' | 'ECHECK' required

Payment method type

statusstring nullable

Payment method status

isPreferredboolean nullable

Whether this is the preferred payment method for the vendor

emailstring email nullable

Email address for payment notifications

phonestring nullable

Phone number for payment contact

companyNamestring nullable

Company name for this payment method (may differ from vendor name)

usernamestring nullable

Username for payment platforms (e.g., Zelle, Venmo)

bankNamestring nullable

Bank name

bankAddressstring nullable

Bank address

accountNamestring nullable

Bank account holder name

accountNumberstring nullable

Bank account number (masked in responses)

abaAchstring nullable

ABA/ACH routing number for electronic transfers

wirestring nullable

Wire transfer routing number

swiftCodestring nullable

SWIFT/BIC code for international transfers

eftInstitutionstring nullable

EFT institution number (Canadian banking)

eftTransitstring nullable

EFT transit number (Canadian banking)

clabestring nullable

CLABE number (Mexican banking identifier)

currencystring nullable

Preferred currency code (ISO 4217)

createdAtstring date-time required

When the payment method was created

updatedAtstring date-time required

When the payment method was last updated

deletedAtstring date-time nullable

When the payment method was soft deleted (null if active)

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "770e8400-e29b-41d4-a716-446655440000",
  "vendor": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-VENDOR-ABC-001",
    "friendlyId": "V123456",
    "name": "ABC Warehouse Services",
    "email": "billing@abcwarehouse.com",
    "phone": "+1-555-123-4567",
    "status": "ACTIVE",
    "currency": "USD",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "paymentMethodType": "ACH",
  "status": "ACTIVE",
  "isPreferred": true,
  "email": "payments@vendor.com",
  "phone": "+1-555-123-4567",
  "companyName": "Vendor Payments LLC",
  "username": "vendor_payments",
  "bankName": "Chase Bank",
  "bankAddress": "123 Bank Street, Dallas, TX 75201",
  "accountName": "Vendor Services Inc",
  "accountNumber": "****1234",
  "abaAch": "021000021",
  "wire": "026009593",
  "swiftCode": "CHASUS33",
  "eftInstitution": "001",
  "eftTransit": "00010",
  "clabe": "012180001234567897",
  "currency": "USD",
  "paymentTerm": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-PAYTERM-NET30",
    "name": "Net 30",
    "description": "Payment due 30 days from invoice date",
    "days": 30,
    "quickPayFee": 0.05,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z",
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  }
}