Zephr User Guide

Configure the Payment Form

0 views 0

To configure the payment form, complete the following steps:

  1. Select the Payment Form Configuration buttonThe Payment Form Configuration screen displays, as illustrated below:


  2. Enter your public key in the Chargify.js Public Key text boxNote: You can find your API key in the Integrations section of your Chargify account
  3. If you want to accept PayPal payments on your site, select the Accept payPal payments checkboxNote: The only payment gateway in Chargify that can accept PayPal payments is Braintree. Ensure that you have linked a Braintree account and configured it as the default gateway for PayPal payments in your Chargify console
  4. If you want to display fields that allows the end user to enter their first and last name, select the Show First Name/Last Name fields checkbox
  5. If you want to display a field that allows the end user to enter their Card Verification Value (CVV), select the Show CVV field checkbox
  6. If you want to display fields that allow the end user to enter their billing address, select the Show Billing Address fields checkboxNotes:
    1. If you do not select any checkboxes that allow the user to enter information, the payment form only displays the following fields:
      • Card number
      • Expiry month
      • Expiry date
    2. The Chargify billing name and address fields correspond to billing information. The name and address user attributes in Zephr correspond to shipping information
    3. If you require country and/or state information for tax reasons but do not want to explicitly ask the end user to supply the information, you can use the Zephr Geosync extension to estimate customer location based on IP address
  7. If you have Multiple Payment Gateways enabled in Chargify, you can route payments for all products in nominated Product Families to a specific Payment Gateway. To do this, enter the gateway configuration in the Product Family -> Payment Gateway Handle Mapping (optional) text boxTo configure your gateway, you need the following information from your Chargify console:
    • The IDs of Product Families in Chargify that you want to mapTo find the IDs, complete the following steps in your Chargify console:
      1. Select Catalog
      2. Select ProductsYour products display, grouped by Product Family. The ID for the Product Family is located next to the headers.
    • The Gateway Handles for your Payment GatewaysTo find the Gateway Handles, complete the following steps in your Chargify console:
      1. Select Config
      2. Select Payment Gateways
      3. Select a gatewayThe handle for the selected gateway displays.

      The routing is configured using a JSON object in the following format:


      This configuration means that any products purchased from the product family with an ID of MY_CHARGIFY_PRODUCT_FAMILY_ID is routed to the payment gateway with a handle of MY_PAYMENT_GATEWAY_HANDLE.

      For example to configure separate gateways for PayPal and card payments, enter the following:

          “My_product_family_id”: {
              “card”: “gateway_handle_for_card_payments”,
              “pay_pal”: “gateway_handle_for_paypal_payments”
  8. Select the Done button to save your payment form configuration and return to the Chargify screen. Selecting the Cancel button displays the Chargify screen without saving any changes

You must recreate the payment form as a feature outcome in Zephr. For further information on creating a payment form in Zephr, see the Payment Forms section.