GET /dialog/contribute/pay_later

Returns an HTML-based dialog that allows users to make a single contribution that they can pay at a later date, using LaterPay’s micropayments via digital invoices.

Example URLs:

Available via HTTPS.

Required Parameters

campaign_id (required)

A unique identifier for tracking your contribution goals (e.g., “2018-christmas-giving”, or “general-fund”). This will be used to show you analytics on how well each of your campaigns is doing. It can be any string consisting of lowercase or uppercase ASCII characters, digits, underscores, and hyphens, the length of which is between 1 and 128 characters.

title (required)

A user-friendly title that explains what the user is contributing to. This will be displayed in the LaterPay dialogs and in the user’s invoice.

url (required)

The URL where the user is sent after they successfully contribute. This might be your homepage, an article on your blog, or a specific landing page set up for your contribution campaign. Users will see this URL in their invoices. You can also specify a return_url (see below).

cp, hmac (required)

Pricing Options

Please choose ONE of the following parameters:

custom_pricing (recommended)

A string containing currency code and price matching your currency (i.e., USD or EUR), plus the amount multiplied by 100. For example: "USD220" translates to $2.20 USD, "EUR340" translates to €3,40 EUR.

This parameter allows you (or your users) to change the contribution amount after the link has already been generated (e.g., manually changing the URL to have custom_pricing=USD900, subject to LaterPay minimum and maximum limits).

NOTE: Do not include this parameter when signing the URL.

pricing

A string containing currency code and price, in the same format as custom_pricing above.

Use this parameter only if you want to make sure that the contribution amount can’t be changed after the URL is generated. You must include this parameter as part of signing the URL.

Note

The custom_pricing and pricing parameters are mutually exclusive. Please do not include both in the same URL.

A complete example URL for USD with custom_pricing:

https://web.uselaterpay.com/dialog/contribute/pay_later?
    permalink=1&
    title=My+Test+Contribution&
    url=http%3A%2F%2Fyourdomain&
    campaign_id=my-contribution-campaign&
    cp=my-merchant-id&
    hmac=cc098ba1e428f4aa3e159892c5573b8a9d71db6849f306d7915a8937&
    custom_pricing=USD220

A complete example URL for EUR with custom_pricing:

https://web.laterpay.net/dialog/contribute/pay_later?
    permalink=1&
    title=My+Test+Contribution&
    url=http%3A%2F%2Fyourdomain&
    campaign_id=my-contribution-campaign&
    cp=my-merchant-id&
    hmac=2d08a25dc46893ee5ab5c5055b2ef3f55a8475f00feeb8743a8fe15c&
    custom_pricing=EUR340

Time Validation Options

Please choose ONE of the following parameters:

permalink (recommended)

If this parameter is present and its value is a 1, the generated link will not expire.

We recommend this for most general user contributions, and especially for use in emails.

ts

Common Parameters

This is the timestamp of when the contribution link was generated. If present, the link will expire after a certain amount of time and your users will no longer be able to use the link.

Use this if you have a specific giving campaign where you want to ensure that users can’t reuse the links to make contributions again later.

Note

The permalink and ts parameters are mutually exclusive. If permalink is 1, do not include the ts parameter.

Optional Parameters

return_url

If you would like the user to be redirected to a different URL than what appears on their invoice, you can optionally provide return_url.

require_login

If this parameter is present and its value is a 1, the user will be asked to log in before they can commit to pay later for the contribution. Otherwise, users can accept the contribution without having to initially sign up for a LaterPay account.