Advanced Features Guide

Integrating giropay with Express Checkout
giropay Integration
6
76 April 2012 Express Checkout Advanced Features Guide
Canceled or Unsuccessful giropay Payment Page Flow
If the giropay payment fails for any reason, such as insufficient funds or the buyer cancels,
PayPal provides details to the buyer to do a bank transfer from their bank account. This
transaction will remain pending until PayPal receives the funds, at which time the transaction
is complete.
If you have disabled non-instant funding transactions for your PayPal account, the transaction
is canceled and PayPal redirects the buyer to your Order Cancel page.
After the bank transfer flow completes, the transaction is pending until the buyer pushes the
funds to PayPal.
If the buyer cancels during the PayPal payment in the bank transfer flow, your Order Cancel
page is displayed.
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, 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.
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:
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.