Acknowledgement Report Specification (Open Wallet API)
DOCS
Last updated: Aug 15th, 8:07am
Important: Open Wallet is a limited-release solution available only to select partners at this time. For more information, reach out to your PayPal account manager.
This report describes the acknowledgements by submission file.
File specifications
The following specifications apply to the Acknowledgement report file:
| Record length | 2000 byte fixed length. |
| File format | UTF-8 encoded. |
| Transmission day and time | Day of the transaction before 3 AM PST. |
| File direction | In general, transmitted from partner to PayPal. |
Field specifications
The following specifications apply to the fields in the Acknowledgement report:
| Position | Field | Type | Length; Start and end positions | Value | Required? | Description | |
|---|---|---|---|---|---|---|---|
| 1 | CLIENT_ID | Alphanumeric, uppercase, left justified, character space filled (if no value) | 11 1 and 11 | N/A | Yes | Unique PayPal-assigned ID to the client. | |
| 2 | FILE_DIRECTION | Alphanumeric, uppercase, left justified, character space filled (if no value) | 1 12 and 12 | -- | Yes | Direction that the submission file is sent: |
1. PayPal to client.2. Client to PayPal.
13 and 24 | System-generated file reference number. Unique across PayPal. Echo back from submission file. | Yes | Contains a submitter-specified file reference number that can be used to track this file. Value should be unique for each file submitted. Use the value in this field is as a file identification and cross-reference to the corresponding file validation report. | | 4 | `FILE_CREATION_DATE` | Numeric, `CCYYMMDD` | 8
25 and 32 | The date when the submission file was created (PST). Echo back from submission file. | Yes | Corresponds to the date when the submitter created the file. The format is `CCYYMMDD`, where:
CC. Century.YY. Year.MM. Month.DD. Day.
33 and 38 | The time when the submission file was created (PST). Echo back from submission file. | Yes | Corresponds to the time when the submitter created the file. The format is `HHMMSS`, where:
HH. Hour (24-hour clock)MM. Minute.SS. Second.
39 and 50 | Unique ID to track the submission file from client. | Yes | -- | | 7 | `FILLER` | Alphanumeric | 1950
51 and 2000 | Character spaces | Yes | Reserved for PayPal internal use. |