METHOD: |
|
|
|
VERSION: |
|
|
|
SUBJECT: |
|
|
|
Main Request Fields: |
AUTHORIZATIONID: |
(Required!) |
|
|
|
The authorization identification number of the payment you want to capture. This is the transaction id returned from DoExpressCheckoutPayment or DoDirectPayment. Character length and limits: 19 single-byte characters maximum.
|
AMT: |
(Required!) |
|
|
|
Amount to capture. Limitations: Value is a positive number which cannot exceed $10,000 USD in any currency. No currency symbol. Must have two decimal places, decimal separator must be a period (.), and the optional thousands separator must be a comma (,).
|
CURRENCYCODE: |
|
|
|
|
A three-character currency code. Default: USD.
|
COMPLETETYPE: |
(Required!) |
|
|
|
The value Complete indicates that this the last capture you intend to make. The value NotComplete indicates that you intend to make additional captures. Note: If Complete, any remaining amount of the original authorized transaction is automatically voided and all remaining open authorizations are voided. Character length and limits: 12 single-byte alphanumeric characters.
|
INVNUM: |
|
|
|
|
Your invoice number or other identification number that is displayed to the merchant and customer in his transaction history. Note: This value on DoCapture will overwrite a value previously set on DoAuthorization. Note: The value is recorded only if the authorization you are capturing is an order authorization, not a basic authorization. Character length and limits: 127 single-byte alphanumeric characters.
|
NOTE: |
|
|
|
|
An informational note about this settlement that is displayed to the payer in email and in his transaction history. Character length and limits: 255 single-byte characters.
|
SOFTDESCRIPTOR: |
|
|
|
|
The soft descriptor is a per transaction description of the payment that is passed to the consumer’s credit card statement. If a value for the soft descriptor field is provided, the full descriptor displayed on the customer’s statement has the following format: <PP * or PAYPAL *><Merchant descriptor as set in the Payment Receiving Preferences><1 space><soft descriptor> The soft descriptor can contain only the following characters: - Alphanumeric characters - - (dash) - * (asterisk) - . (period) - {space} If you use any other characters (such as “,”), an error code is returned. The soft descriptor does not include the phone number, which can be toggled between the merchant’s customer service number and PayPal’s customer service number. The maximum length of the total soft descriptor is 22 characters. Of this, either 4 or 8 characters are used by the PayPal prefix shown in the data format. Thus, the maximum length of the soft descriptor passed in the API request is: 22 - len(<PP * or PAYPAL *>) - len(<Descriptor set in Payment Receiving Preferences> + 1) For example, assume the following conditions: - The PayPal prefix toggle is set to PAYPAL * in PayPal’s admin tools. - The merchant descriptor set in the Payment Receiving Preferences is set to EBAY. - The soft descriptor is passed in as JanesFlowerGifts LLC. The resulting descriptor string on the credit card would be: PAYPAL *EBAY JanesFlow
|
test: |
CUSTOM: |
|
|
|
|
A free-form field for your own use. Character length and limitations: 256 single-byte alphanumeric characters
|
wait........ |
|
|