Stripe Feed Meta

Introduction

The Feed Object meta for the Stripe add-on is an associative array containing the properties which determine what type of transaction should occur and what values are sent to Stripe.

$feed['meta'] = array(
    'feedName'                       => 'Your Feed Name',
    'transactionType'                   => 'product',
    'paymentAmount'                   => 'form_total',
    'receipt_field'                      => '3',
    'feed_condition_conditional_logic'       => true,
    'feed_condition_conditional_logic_object' => array(
        'conditionalLogic' => array(),
    ),
);

Usage

We recommend accessing the $feed meta using the rgar() or rgars() functions, e.g.:

$conditional_logic_enabled = rgars( $feed, 'meta/feed_condition_conditional_logic' );

Properties

  • feedName string

    The feed name which appears on the add-ons feeds tab.

  • transactionType string

    The type of transaction which should occur when the feed is processed. Possible values: product or subscription.

  • metaData array

    An indexed array of custom meta information. Stripe allows a maximum of 20 custom keys to be sent. Each custom meta array contains the following properties.

        array(
        'key'        => 'gf_custom',
        'value'      => '1.3',
        'custom_key' => 'product_quantity',
    );
    • key string

      Value should be gf_custom. Instructs the dynamic_field_map setting to use the custom_key input.

    • value string

      The ID of the field containing the value to be sent for the specified custom_key. The mapped data will be truncated to 500 characters per requirements by Stripe.

    • custom_key string

      The custom key you want to use when sending the custom metadata to Stripe. Must be 40 characters or less.

  • feed_condition_conditional_logic boolean

    Is the feed condition (conditional logic) setting enabled. Default is false.

  • feed_condition_conditional_logic_object array

    An associative array containing the conditional logic rules. See the Conditional Logic Object for more details.

Product Transaction Properties

The following properties are only applicable when the transactionType is set to product.

  • paymentAmount string

    What to use for the payment amount. Possible values: form_total or a product field ID.

  • receipt_field string

    The ID of the field containing the email Stripe should use when sending their receipt.

Subscription Transaction Properties

The following properties are only applicable when the transactionType is set to subscription.

  • recurringAmount string

    What to use for the recurring amount. Possible values: form_total or a product field ID

  • billingCycle_length integer

    How often should the recurring payment occur. Maximum values: 1 year or 12 weeks or 12 months.

  • billingCycle_unit string

    How often should the recurring payment occur. Possible values: week, month or year.

  • setupFee_enabled boolean

    Should a setup fee be charged? Default is false.

  • setupFee_product string

    The ID of the product field containing the amount the user should be charged for the setup fee.

  • trial_enabled boolean

    Should the recurring charge occur immediately or after a trial period? Default false.

  • trialPeriod integer

    The number of days the trial period should last.

  • customerInformation_email string

    The ID of the field containing the customer email.

  • customerInformation_description string

    The ID of the field containing the customer description.