Rainforest supports collecting the end user's billing contact directly from a digital wallet, such as Apple Pay, PayPal, Venmo, and PayPal Pay Later.

Collect when processing payments

When creating the payin config, two new fields can be set to collect billing contact details from the end user in the wallet flow.

• request_wallet_address - retrieves the name and address from the digital wallet
• request_wallet_contact - retrieves the email from the digital wallet

{
  ...
  "amount": 10000,
  "currency_code": "USD",
  "billing_contact": {
    "name": "John Smith",
    ...
+   "request_wallet_address": true,
+   "request_wallet_contact": true
  }
}

The billing contact details collected from the wallet will be returned on the payin and stored on the payment method for future payment methods.

Name and address

If the request_wallet_address is set to true, then the digital wallet flow will collect the name and address from the end user. The address details collected from the wallet will override the name and address provided by the platform in the payin config.

Apple Pay supports collecting both the name and address from the end user.

PayPal, Venmo, and PayPal Pay Later support only collecting the name. The address provided in the payin config will be set on the payin and payment method even when request_wallet_contact is true.

Email

If the request_wallet_contact is set to true, then the digit wallet flow will collect the email from the end user. The contact details collected from the wallet will override the email provided by the platform in the payin config.

This is supported for PayPal, Venmo, and PayPal Pay Later.

Collecting email is not supported for Apple Pay. For an Apple Pay payment, the email provided on the payin config will be set on the payin and payment method even when request_wallet_contact is true.

Phone

Collecting phone number is not supported through any digital wallet.

Collect when storing payment methods

If your integration is only storing a payment method, then the same request_wallet_address and request_wallet_contact fields can be set when creating the payment method config.

The billing contact details collected from the wallet will be returned on the payment method.

For future payins from stored payment methods, if billing contact is passed into the payin config, then the payin config values will take precedence over the billing contact currently stored on the payment method and will merge with the existing billing contact on the payment method.

Billing contact on configs

The billing contact on the payin config and payment method config will not be updated and represents what the platform initiated.