Checkout Forms

Checkout Forms are a low-code solution that enables you to create a customizable payment page where buyers can easily enter their payment details and submit a payment on both desktop and mobile devices.

Using Checkout Forms you can quickly create a checkout page and accept payments from buyers with minimal dev work.

Related Guides: Checkout Forms

Create a Checkout Form

Create a Checkout Form to accept the details of buyers.

Related guides: Checkout Forms.

Request
header Parameters
Finix-Version
string
Default: 2018-01-01

Specify the API version of your request. For more details, see Versioning.

Example: 2022-02-01
Request Body schema: application/json
merchant_id
required
string

The ID of the Merchant the payment is getting created under.

Only approved Merchants with one of the following processors can create checkout pages: DUMMY_V1, LITLE_V1 or FINIX_V1.

payment_frequency
required
string

Details if a payment created from a checkout form is:

  • ONE_TIME
  • RECURRING
At this time, only ONE_TIME is supported.

is_multiple_use
boolean

If set to True, the checkout form can be used for multiple purchases.

allowed_payment_methods
required
Array of strings

Payment methods allowed on the checkout form.

nickname
required
string

Descriptor name of the checkout form.

items
Array of arrays
Default: []

An itemized list of products/services.

object

Object containing details about the buyer. This object is only used for SINGLE_USE checkout forms.

object

Object containing details about the amount getting charged.

object

Object containing branding details for the checkout form.

object

Object containing additional details about the checkout form.

object or null

Include up to 50 key: value pairs to annotate requests with custom metadata.

  • Maximum character length for individual keys is 40.
  • Maximum character length for individual values is 500. (For example, order_number: 25, item_type: produce, department: sales)
Responses
200

Example response

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

406

Not Acceptable

422

Invalid field

post/checkout_forms
Request samples 
Response samples 
application/json
{}
List Checkout Forms
Retrieve a list of Checkout Forms. 


For details on how to query endpoints using the available parameters, see Query Parameters.


Request 
header Parameters
Finix-Version
string
 Default:  2018-01-01
Specify the API version of your request. For more details, see Versioning.


 
 Example:  2022-02-01
Responses 
200
Example response


401
Authentication information is missing or invalid


403
Forbidden


404
Object does not exist


406
Not Acceptable


422
Invalid field


get/checkout_forms
Request samples 
curl "https://finix.sandbox-payments-api.com/checkout_forms" \
-H "Finix-Version: 2022-02-01" \
-u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda

Response samples 
application/json
{}
Fetch a Checkout Form
Retrieve the details of a previously created Checkout Form.


Request 
path Parameters
checkout_forms_id
required
string
 
header Parameters
Finix-Version
string
 Default:  2018-01-01
Specify the API version of your request. For more details, see Versioning.


 
 Example:  2022-02-01
Responses 
200
Example response


401
Authentication information is missing or invalid


403
Forbidden


404
Object does not exist


406
Not Acceptable


422
Invalid field


get/checkout_forms/{checkout_forms_id}
Request samples 
curl "https://finix.sandbox-payments-api.com/checkout_forms/checkout_form_ciADaDNMFAHdyNbDPuByS" \
-H "Finix-Version: 2022-02-01" \
-u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda

Response samples 
application/json
{}