Simple Payments First you need to add a button to your website and add "Pay Now" as the button text. Below you will find examples of the most popular E-commerce Platforms. If you cannot find yours in the list, let us know.
WIX Click here(opens new window) to see how to add a button to your WIX site.
Squarespace Click here(opens new window) to see how to add a button to your Squarespace site.
WordPress Click here(opens new window) to see how to add a button to your WordPress site.
Shopify Click here(opens new window) to see how to add a button to your Shopify site.
2. Copy your URL from the Control Panel Log in to the Control Panel and go to Simple Payments/Pages. Choose the form you want to use. Click on the 3 dots and Copy Page URL.
All you have to do is add the URL to the button. Replace your URL with the one between the quotation marks.
Url Parameters Custom Fields Comma separate the custom field ids and values you want to prefill. You can get the custom field id from the Control Panel under Manage->Custom Fields.
Colon separate the custom field id and value.
Products Comma separate the product ids and quantities you want to prefill. You can get the product id from the Control Panel under Shopping->Products->Edit Product->Id(upper right hand corner).
Colon separate the product id, quantity, price
API Create a new product Request Method: POST
URL Endpoint: /api/merchant/{merchantid}/product
Name Type Default Description Required Regex sku string Product Sku true ([0-9a-z]{0-20}) name string display name true ([0-9a-z -]{0-100}) img string product image (base64 encoded) false price unsigned int unit price true ([0-9a-z -]{0-100}) fixed_amount boolean should we lock the amount or allow the end user to customize the amount true fixed_qty boolean should we lock the quantity or allow the end user to customize the quantity true description string item description true 254 characters
Create a new recurring plan Request Method: POST
URL Endpoint: /api/recurring/plan
Name Type Default Description Required Regex name string plan name true ([0-9a-z -]{0-100}) amount unsigned int Amount to be billed in cents (100 = $1.00) true ([0-9a-z -]{0-100}) currency string currency "USD" true USD billing_cycle_interval integer How often to run the billing cycle (run every X months) billing_frequency string literal "monthly" How often to run the plan within a billing cycle. ("monthly", "twice_monthly", "daily") * billing_days string null Which day of the month to bill on. If "twice_monthly" then comma separate dates ("1, 15"). For the last day of the month, use "0". * duration integer 0 Number of times for the discount to be billed (use 0 if you want the plan to persist until cancelled) features.allow_custom_amount boolean false Shoule we allow a custom amount to be used true ([0-9a-z -]{0-100}) add_ons array of objects Enumerates add-ons for a recurring plan add_ons[#]id string ID of the referenced add_on add_ons[#]name string Display name for the add_on (optional, this overrides the add_ons value) add_ons[#]description string Description for the add_on (optional, this overrides the add_ons value) add_ons[#]amount int Amount to be added (optional, this overrides the add_ons value) add_ons[#]duration int Duration for the add_on to be billed (optional, this overrides the add_ons value) discounts array of objects Enumerates discounts for a recurring plan discounts[#]id string ID of the referenced discount discounts[#]name string Display name for the discount (optional, this overrides the discount value) discounts[#]description string Description for the discount (optional, this overrides the discount value) discounts[#]amount int Amount to be discounted (optional, this overrides the discount value) discounts[#]duration int Duration for the discount to be billed (optional, this overrides the discount value)
Create a new custom field Request Method: POST
URL Endpoint: /api/customfields
Name Type Default Description Required Regex name string display name true ([0-9a-z -]{0-100}) type string group name for referencing groups of custom fields ([0-9a-z]{0-50}) group_name string group name for referencing groups of custom fields ([0-9a-z]{0-50}) required boolean should we require this field false validation_type string How should we validate these values. (open values array({name:string, value: string}) Values are an array of objects with keys of name and value
Create a new Simple Payments page Request Method: POST
URL Endpoint: /api/merchant/{merchantid}/simple-payment
Name Type Default Description Required Regex form_type string Simple Payments Page Type (donation) slug string This is the URL slug appended to /spp/{slug} true ([0-9a-z]{0-20}) name string display name true ([0-9a-z -]{0-100}) title string Simple Payments Page Title true ([0-9a-z -]{0-100}) description string Simple Payments Page description true 254 characters payment_settings array of objects Enumerates payment types to accept payment_settings[#]payment_method string Allows card and ach payments (card ach) layout string Page Layout to use. true (full image_url string Page image (base64 encoded) false background_color string Background color to use, only if not using layout full true amount_header string Page heading over Amounts section false ([0-9a-z -]{0-100}) amount_options array of unsigned integers Enumerates predefined amounts to accept manual_amount boolean Should we allow custom amounts to be entered? Only available if not using products or plans false plans_header string Page heading over Plans section false ([0-9a-z -]{0-100}) plan_ids array of strings Enumerates plan ids to make available products_header string Page heading over Products section false ([0-9a-z -]{0-100}) products_ids array of strings Enumerates product ids to make available custom_fields_header string Page heading over Custom Fields section false ([0-9a-z -]{0-100}) custom_field_ids array of strings Enumerates custom fields ids to make available success_url string Where to redirect after a successful payment false
