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.

Array of objects

Details the items or services used in the checkout form.

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 by the checkout form.

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 USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
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_c6dyWA9HiFkNkbXgeAoqP" \
-H "Finix-Version: 2022-02-01" \
-u USksBJMwkNUz5GyxPevL2yFY:71b641c1-861d-435b-9a9c-532760731c5e
Response samples
application/json
{}