💳 PaymentDetail Resource Advanced

Direct payment method management for specialized scenarios

Direct access to payment detail record management, typically used for bulk payment imports, cross-entity payment management, and specialized validation workflows. Most payment detail creation and management should occur through BizEntity operations, which handle complete payment setups with proper relationship management and deduplication.

4
Endpoints
1
Core DTO
Multiple
Payment Types
Secure
Storage
💰

Payment Method Management

Payment instrument management supporting Australian bank accounts, credit cards, BPAY, direct debit, and international payment methods with validation and security features.

🔒

Secure Storage

Secure storage of payment information with BSB format validation for Australian bank accounts and support for international payment details.

🏦

Banking & Transaction Integration

Support for Australian banking details (BSB/account), international payment routing (SWIFT/IBAN), and integration with deposit and distribution operations.

Available Endpoints

Core Operations

GET Get PaymentDetails Query payment details by entity or payment type
POST Create PaymentDetail Create payment detail with banking information
PUT Update PaymentDetail Update payment details and banking information
DELETE Delete PaymentDetail Remove with transaction validation

Core Data Transfer Objects

PaymentDetailDTO All PaymentDetail endpoints Payment method structure (26 properties) with Australian banking (BSB, account number), international payments (SWIFT, IBAN, intermediary bank details), transaction routing flags (deposit, distribution, redemption), and entity ownership via dual IDs

Use Cases & Scenarios

Most payment management occurs through BizEntity operations. Use direct PaymentDetail endpoints for bulk payment imports, cross-entity banking updates, or financial system migration scenarios.

→ See BizEntity Overview for standard entity operations

Business Rules & Constraints

BizEntity Integration & Data Integrity

  • Exclusive ownership: PaymentDetail records belong to BizEntity for centralized payment method management
  • Payment prioritization: Primary/default payment method designation for automated processing workflows
  • Transaction integration: Integration with deposit, redemption, and distribution payment processing
  • BizEntity context: Payment method creation and management primarily occur through BizEntity operations for relationship integrity

Payment Information & Validation

  • Secure storage: Payment information stored securely within the platform infrastructure
  • BSB format: Australian BSB fields support 6-digit BSB format for domestic bank accounts
  • International support: SWIFT and IBAN fields support international payment routing and wire transfers
  • Payment type validation: PaymentTypeID references valid payment type lookup values determining payment method classification

Referential Integrity & Management

  • Referential integrity: Cannot delete payment methods if referenced by active transaction workflows
  • Dual ID system: Native IDs for performance, External IDs for third-party system integration
  • External integration: ExternalPaymentDetailId supports third-party system integration and idempotency