
Direct Payment API
DoDirectPaymentRequest
52 July 2006 Web Services API Reference
DoDirectPaymentRequest
Request to use PayPal Direct Payment to obtain payment.
You must include the PaymentAction element in DoDirectPaymentRequest. Allowable
values for the PaymentAction element are Sale or Authorization:
z Set PaymentAction to Sale if the buyer’s order is final (for example, if the total cost of
the order is complete with shipping, handling and tax charges). This transaction is your
payment, and you expect no additional charge to the buyer.
z Set PaymentAction to Authorization if the total cost of the order at point of sale is
not complete for some reason (such as unknown shipping charges) and you expect to
capture funds after checkout is complete. You can then use PayPal Authorization &
Capture to obtain payment.
In either case, besides the PaymentAction element, DoDirectPaymentRequest requires
additional elements, such as the amount of the transaction, IP address of the buyer’s browser,
credit card number, type, and expiration date, and information about both the payer and the
payment.
Fields
TABLE 5.1 DoDirectPaymentRequest Fields
Element Description Data Type
Allowable
Values
Required
?
PaymentAction How you want to obtain payment:
z Authorization indicates that this payment is a
basic authorization subject to settlement with
PayPal Authorization & Capture.
z Sale indicates that this is a final sale for which
you are requesting payment.
Character length and limit: Up to 13 single-byte
alphabetic characters
ebl:PaymentAction
CodeType
xs:token
Default: The
transaction
resulting from
DoDirect
Payment
Request
will be a
final sale.
Authorization
Sale
NOTE: Order is
not allowed
for Direct
Payment.
No
CreditCard Information about the credit card to be charged.
ebl:CreditCard
DetailsType
See Table 5.2 on
page 53.
Yes
PaymentDetails
Information about the payment
ebl:PaymentDetails
Type
See Table 5.3 on
page 54.
Yes
Komentarze do niniejszej Instrukcji