# Simple Payments

# Add a Pay Now Button to your Website

# 1. Add a button to your website

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.

# 3. Add the URL to the button

All you have to do is add the URL to the button. Replace your URL with the one between the quotation marks.

<a href="{https://sandbox.basysiqpro.com}/spp/example-page">Pay Now</a>

# Simple Payments API Reference

# Create a new product

Request Method: POST

URL Endpoint: /api/merchant/{merchantid}/product

Name	Type	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	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	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