MODIFYACCOUNT
The MODIFYACCOUNT command is used to change the attributes of a specified Account object.
| Keywords | Required | Value |
|---|---|---|
| ACCOUNTNUMBER | Yes | Integer in ASCII characters. Must be from 1 to 999999999. In conjunction with MERCHANTNUMBER and CASSETTENAME, uniquely identifies the target Account for this command. |
| ACCOUNTTITLE | No | UTF-8 string that is either null or from 1 to 254 bytes. If present, the value passed in will replace the AccountTitle specified Account object. |
| APAPPROVEFLAG | No | Approve flag for AcceptPayment. ASCII character string.
|
| APDEPOSITFLAG | No | ASCII character string 0 or 1, where 0 and 1 denote false and true. Only specified if APAPPROVEFLAG is defined and not set to 0. Otherwise PRC_INVALID_PARAMETER_ COMBINATION_, RC_AP_DEPOSITFLAG will be returned. |
| APPROVALEXPIRATION | No | Integer value that indicates the number of days after a payment has been approved that the approval expires. This field supports configurable approval expiration where this setting controls whether a payment approval associated with the account will expire after the elapsed time. A value of 0 implies no expiration. When a payment approval expires, it will be placed in the ApprovalExpired state. Note: A cassette is allowed to cause payment approvals to expire independently of this setting, but this parameter allows the framework to detect payment approval expiration on behalf of the cassette. For a description of the ApprovalExpired state see: Payment states |
| CASSETTENAME | Yes | ASCII character string from 1 to 64 bytes. In conjunction with MERCHANTNUMBER and ACCOUNTNUMBER, uniquely identifies the target Account for this command. |
| DTDPATH | No | Path to the locally-stored DTD. The value of this parameter is used in the XML document to specify the location of the external DTD. If this parameter is not specified, the complete DTD is returned as an internal DTD. The length of the DTDPath must be from 1 to 254 bytes. |
| ENABLED | No | ASCII character string "0" or "1", where 0 and 1 denote
false and true. If present, the value passed in will replace
the Enabled field of the Account object. Indicates whether the Account object should be active. |
| ETAPIVERSION | Yes | 3 (Indicates WebSphere Commerce Payments-or predecessor product-API version: Version 2.1.x, 2.2.x, 3.1.x, 5.5.x, and 5.6.x) |
| FINANCIALINSTITUTION | No | UTF-8 string that is either null or from 1 to 255 bytes. If present, the value passed in will replace the FinancialInstitution specified Account object. |
| MERCHANTNUMBER | Yes | Integer in ASCII characters. Must be from 1 to 999999999. In conjunction with CASSETTENAME and ACCOUNTNUMBER, uniquely identifies the target Account for this command. |
| OPERATION | Yes | ASCII character string "ModifyAccount". |
| RPAPPROVEFLAG | No | Approve flag for ReceivePayment. ASCII character string "0", "1", or
"2". Default is "0"
|
| RPDEPOSITFLAG | No | ASCII character string 0 or 1, where 0 and 1 denote false and true. Only specified if RPAPPROVEFLAG is defined and not set to 0. Otherwise PRC_INVALID_PARAMETER_ COMBINATION_, RC_RP_DEPOSITFLAG will be returned. |
Note: APAPPROVEFLAG AND RPAPPROVEFLAG values are superceded by the
API Approve flag when the API approve flag contains a non-zero, non-null value.