Job Runner

Create Payment Link of Stripe

Summary

Create a payment link of Stripe.

A payment link is the URL of a product payment page created on Stripe. Users who have purchased the product can make a payment using that URL. For more details, see the Stripe’s documentation .

How to Use

You need to issue the Stripe API key in advance. Stripe initially provides a standard key, but you should issue a restricted key instead of using the standard one. For details of the procedure, Stripe’s website . This is a setting on the Stripe screen, not Customine.

There is no need to register product data in advance on Stripe. Customine’s “Create Payment Link of Stripe” automatically registers products on Stripe. Conversely, to link products that are already registered with Stripe to Kintone records, add metadata to the Stripe product and set the product code with the key product_code.

When you execute this Do, it will register a product and price data on Stripe and create a payment link. The created payment link can be checked from “Payment Links” on the Stripe screen.

If you include the product code in the Mapping to Line Item, the product data on Stripe will be updated if that product code is already registered. If not, new product data will be added on Stripe.

When this action is executed and a payment link is created on Stripe, the combination of the payment link ID and URL will be set as the result of the action. For example, if the action of “Create Payment Link of Stripe” is the first action, and you want to extract the ID of the payment link, write an expression like the following:

= $1.id

Similarly, to extract a URL, write it as follows: You can share this URL with the person who purchased the product.

= $1.url

Parameter

Set Stripe API Key, Source Records, Mapping to Line Item, and Currency.

Stripe API Key

Specify the API key that was issued in advance.

There are three types of keys in Stripe’s API: Standard Key’s Publishable Key, Standard Key’s Secret Key, and Restricted Key, but you need to use the Restricted Key.

This API key requires the following permissions:

  • Files: Writing (required only when registering product images; it is unnecessary if no images are to be registered.)
  • Payment Links: Writing
  • Prices: Writing
  • Products: Writing

Source Records

Specify a separate record for each product or service. A number of product details equal to the number of records will be created within one payment link.

This record must contain at least one line. An error will occur at runtime if it is empty.

Mapping to Line Item

Enter the detailed information of the statement in a mapping format.

In mapping, expressions can be used. If a field code is specified in the expression during mapping, that field will become a field of the “Source Records.”

Map to the following elements:

  • Product Code
    • If you specify this, if a product with the same product code is already registered on Stripe, the product data will be overwritten and updated. If the code is not already registered, it will be registered as a new code.
    • If omitted, product data will be newly registered on Stripe each time.
    • It will not be displayed on the screen of the person who will purchase the product.
  • Product Name
    • This is the name of the product displayed on the screen of the person who will purchase the product.
    • Required field.
  • Product Description
    • This is the product description displayed on the screen of the person who will purchase the product.
    • This parameter is optional.
  • Product Image
    • This is the product image displayed on the screen of the person who will purchase the product.
    • This parameter is optional.
    • To specify it, specify the attachment field in the expression. The first image attached in that attachment field will be the product image. Attached files other than images will be ignored.
      • If you know which file in the attachment field is the product image, you can specify that number. For example, to specify the second file: 
        = Attachment Field[1]

        In the formula, the count starts from zero, so specify 1 for the second one.

    • The product image will be overwritten when you set this parameter.
    • If omitted or if no image is attached to the specified attachment file field, no image will be set for the product. In this case, the already set image will be maintained.
    • In the customization, the API token ("Set Kintone API Token") to retrieve files from the attachment field must be set. Usually, an API token should already be used to obtain the “Source Records,” so there is no need to worry about it.
  • Unit Price
    • Specify how much to sell this product for per item in this payment link.
    • Required field.
    • If the currency unit is in dollars, it is specified in cents. For example, to sell for 10 USD, specify 1000. Similarly, specify the euro in euro cents.
    • Specify the price, including tax.
  • Quantity
    • Specify how many to sell.
    • This parameter is optional. In the case of omission, it will be specified as 1.
  • Maximum Quantity, Minimum Quantity
    • If specified, the person who will purchase the product will be able to change the quantity they purchase, and will be the range of selectable quantities.
    • This parameter is optional. If both maximum and minimum are omitted, the person who will purchase the product cannot change the quantity and it will be fixed at the number specified in Quantity.

Currency

Select a currency unit. You can choose yen, dollars, or euros. Other currencies are not supported.

When you specify the currency as dollars or euros, pay attention to the unit of the unit price in Mapping to Line Item.

Restrictions

  • The range of values that can be specified, such as unit price and quantity, and the supported image formats depend on the Stripe’s specifications.
  • The rich editor field is not supported. When specifying the value of the rich editor field in the product name and product description, the HTML is displayed as is.
  • You cannot register multiple images for a single product.