Integration Guide

Table Of Contents
Express Checkout Integration Guide October 2009 109
Integrating giropay with Express Checkout
giropay Integration
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 customer
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 Customer to PayPal
After selecting a funding source on PayPal, the customer 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 customer from your Order Review page to
https://www.paypal.com/webscr?cmd=_complete-express-checkout
&token=<token>.
PayPal then redirects the customer 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 customer 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 customer to back to PayPal