Create a digital payment account assignment

post

/fscmRestApi/resources/11.13.18.05/paymentsExternalPayees/{PayeeId}/child/digitalPaymentAccountAssignments

Request

Path Parameters
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the virtual card digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the virtual card digital payment account.
  • Title: Alias
    Maximum Length: 150
    Alias used to represent the digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the digital payment account.
  • Title: Bank Account
    Maximum Length: 100
    Bank account assigned to the digital payment account.
  • Title: Country Code
    Maximum Length: 2
    Country code of the digital payment account.
  • Title: Currency Code
    Maximum Length: 15
    Currency code of the digital payment account.
  • Title: Registration Status
    Maximum Length: 80
    Registration status of the provider for the digital payment account.
  • Title: Display Name
    Maximum Length: 150
    Display name of the digital payment account.
  • Title: Digital Payment Account ID
    Unique identifier of the digital payment account.
  • Title: End Date
    The date when the relationship between the payment instrument and the payer or payee becomes inactive in the payment instrument assignment.
  • Title: Inactive On
    The date when the digital payment account expires.
  • Title: Primary
    Maximum Length: 30
    Indicates whether the payment instrument is the primary payment instrument for the payer or payee within the instrument assignment. A primary payment instrument automatically populates the transactions.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for a separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Remittance advice identifier used for separate remittance advice processing.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for a separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional remittance advice identifier used for separate remittance advice processing.
  • Title: Start Date
    The date when the relationship between the payment instrument and the payer or payee becomes active in the payment instrument assignment.
  • Title: Token
    Maximum Length: 150
    Substitute identifier of the digital payment account.
  • Title: Card Program
    Maximum Length: 100
    Virtual card program associated with the digital payment account.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : paymentsExternalPayees-digitalPaymentAccountAssignments-item-response
Type: object
Show Source
  • Title: Account Usage Type
    Read Only: true
    Maximum Length: 80
    Purpose of the digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the virtual card digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the virtual card digital payment account.
  • Title: Alias
    Maximum Length: 150
    Alias used to represent the digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the digital payment account.
  • Title: Alias
    Maximum Length: 150
    Additional alias used to represent the digital payment account.
  • Title: Alias Type
    Read Only: true
    Maximum Length: 80
    Type of alias used to represent the digital payment account.
  • Title: Bank Account
    Maximum Length: 100
    Bank account assigned to the digital payment account.
  • Title: Card Platform
    Read Only: true
    Maximum Length: 80
    Name of the payment system used by the virtual card program.
  • Title: Country Code
    Maximum Length: 2
    Country code of the digital payment account.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the digital payment account assignment.
  • Title: Creation Date
    Read Only: true
    The date and time when the digital payment account assignment was created.
  • Title: Currency Code
    Maximum Length: 15
    Currency code of the digital payment account.
  • Title: Registration Status
    Maximum Length: 80
    Registration status of the provider for the digital payment account.
  • Title: Display Name
    Maximum Length: 150
    Display name of the digital payment account.
  • Title: Digital Payment Account ID
    Unique identifier of the digital payment account.
  • Title: End Date
    The date when the relationship between the payment instrument and the payer or payee becomes inactive in the payment instrument assignment.
  • Title: Inactive On
    The date when the digital payment account expires.
  • Title: Instrument Payment Use ID
    Read Only: true
    Unique identifier of the instrument assignment.
  • Title: Instrument Type
    Read Only: true
    Maximum Length: 80
    Type of payment instrument used in the instrument assignment.
  • Title: Start Date
    Read Only: true
    The date when the digital payment account was issued.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the digital payment account assignment was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the digital payment account assignment.
  • Links
  • Title: Owner Party Name
    Read Only: true
    Maximum Length: 360
    Party name of the digital payment account owner.
  • Title: Owner Party Number
    Read Only: true
    Maximum Length: 30
    Party number of the digital payment account owner.
  • Title: Payment Flow
    Read Only: true
    Maximum Length: 80
    Payment flow that determines whether the instrument assignment is used for outgoing or incoming payments.
  • Title: Payment Mode
    Read Only: true
    Maximum Length: 80
    Payment method used by the digital payment account.
  • Title: Primary
    Maximum Length: 30
    Indicates whether the payment instrument is the primary payment instrument for the payer or payee within the instrument assignment. A primary payment instrument automatically populates the transactions.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for a separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Remittance advice identifier used for separate remittance advice processing.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional unique identifier for a separate remittance advice.
  • Title: Remit Advice Identifier
    Maximum Length: 150
    Additional remittance advice identifier used for separate remittance advice processing.
  • Title: Remit Advice Identifier Type
    Read Only: true
    Maximum Length: 80
    Type of remittance advice identifier assigned to the digital payment account.
  • Title: Start Date
    The date when the relationship between the payment instrument and the payer or payee becomes active in the payment instrument assignment.
  • Title: Straight Through Processing
    Read Only: true
    Maximum Length: 1
    Indicates whether straight through processing is enabled for the digital payment account.
  • Title: Token
    Maximum Length: 150
    Substitute identifier of the digital payment account.
  • Title: Token Type
    Read Only: true
    Maximum Length: 80
    Type of token assigned to the digital payment account.
  • Title: Card Program
    Maximum Length: 100
    Virtual card program associated with the digital payment account.
Back to Top