PayPal Express Checkout - 2012 Podręcznik Użytkownika Pobierz pdf (Strona 43)

Express Checkout Integration Guide August 7, 2012 43

Related API Operations

Tracking Failed or Pending Requests

same MsgSubID. In contrast, a request with no accompanying MsgSubID will instead

duplicate the request.

Scenarios in which idempotency come into play:

 In an API request sent with a MsgSubID times out, a client application can retry the

original request using the accompanying MsgSubID. If the request has finished processing,

PayPal then provides the latest status of the request and might return a 11607 warning

code (Duplicate request for specified Message Submission ID).

 If a client application sends two API requests with same MsgSubID at the same time,

PayPal processes the first request and the other may fail with 11604 error code (Request

for Message Submission ID already in progress).

NOTE: For DoExpressCheckoutPayment, you can use the token in place of the

MsgSubID. For mutliple payments, a combination of the token and

PaymentRequestID should be used in place of the MsgSubID.

The following example shows MsgSubID used as part of a DoAuthorization request:

<__value__>

<m__value>Order</m__value>

</__value__>

</transactionEntity>

<__value>10</__value>

<__value__>

<m__value>USD</m__value>

</__value__>

</currencyID>

</amount>

Usage Notes:

 The MsgSubID must be unique for each request and, as a best practice, should be unique to

an API call type (e.g. DoAuthorization, DoCapture).

 PayPal recommends using the UUID standard for assigning a MsgSubID to your request,

since it meets the 38 single-byte character limit for MsgSubID.

 Idempotency only applies when the original request was successful. If the original request

results in an error, the original request is not saved.

 PayPal reserves the right to expire a MsgSubID after 13 days.

 PayPal provides the status of a request at the current time and not the status of the initial

request. Take for example, an initial request that makes a payment (status is Complete).

The payment is later refunded. If the original request with the original MsgSubId is

resubmitted, the response will indicate that the payment status is Refunded.

1 2 ... 38 39 40 41 42 43 44 45 46 47 48 ... 77 78

Brak uwag

PayPal Express Checkout - 2012 Podręcznik Użytkownika Strona 43