Integration Guide

Table Of Contents
Express Checkout Integration Guide May 2010 133
Integrating giropay with Express Checkout
giropay Integration
13
giropay Integration
If you offer the giropay payment option, you must take additional steps to integrate with the
Express Checkout flow.
Initiate the Flow with SetExpressCheckout
To support giropay payments, you pass the following three URLs as part of the
SetExpressCheckout request. These URLs tell PayPal where to redirect the buyer based on
the success or failure of each type of payment transaction. See the PayPal Name-Value Pair
Developer Guide and Reference for more information.
SetExpressCheckout request fields for giropay
Redirect the Buyer to PayPal
After selecting a funding source on PayPal, the buyer is redirected back to your website, as in
the regular Express Checkout flow. There is one additional field, REDIRECTREQUIRED,
returned in the response from both GetExpressCheckoutDetails and
DoExpressCheckoutPayment.
If the value of this field is true, you redirect the buyer from your Order Review page to
https://www.paypal.com/webscr?cmd=_complete-express-
checkout&token=
<value_from_SetExpressCheckoutResponse>. PayPal then redirects the
buyer from this redirect page to the necessary page for the selected funding source.
GetExpressCheckoutDetails and DoExpressCheckoutPayment response field
The GetExpressCheckoutDetails response contains the REDIRECTREQUIRED field,
which lets you know if you need to redirect the user after your Order Review page. You can
use this value to inform the buyer on your Order Review page that they will be sent to the
giropay website to complete the order.
NVP Field Description
GIROPAYSUCCESSURL The URL on the merchant site to redirect to after a successful giropay payment.
GIROPAYCANCELURL The URL on the merchant site to redirect to after a giropay or bank transfer
payment is cancelled or fails.
BANKTXNPENDINGURL The URL on the merchant site to transfer to after a bank transfer payment.
NVP Field Description
REDIRECTREQUIRED Flag to indicate whether you need to redirect the buyer to back to PayPal