Application Profiles

The application_profile resource is used to configure the Application's Fee Profile. The Application's Fee Profile configures what Fee gets applied to transactions processed by the application_profile.

Related Guides: Onboarding Process, Collecting Fees

List Application Profiles

Retrieve a list of application_profiles.

Request
query Parameters
limit
integer

The numbers of items to return.

Example: limit=10
after_cursor
string

Return every resource created after the cursor value.

before_cursor
string

Return every resource created before the cursor value.

header Parameters
Accept
string
Default: application/hal+json
Responses
200

List of application_profile objects

401

Authentication information is missing or invalid

403

Forbidden

406

Not Acceptable

get/application_profiles
Request samples 
curl "https://finix.sandbox-payments-api.com/application_profiles" \
  -H "Finix-Version: 2022-02-01" \
  -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
Response samples
application/json
{}

Fetch Application Profile

Retrieve the details of an existing application_profile.

Request
path Parameters
application_profile_id
required
string

ID of Application profile to use.

header Parameters
Accept
string
Default: application/hal+json
Responses
200

Single application_profile object

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

406

Not Acceptable

get/application_profiles/{application_profile_id}
Request samples 
curl "https://finix.sandbox-payments-api.com/application_profiles/PPqjTEKAmRNGLquQUeLKmXhi" \
  -H "Finix-Version: 2022-02-01" \
  -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
Response samples
application/json
{}

Update Application Profile

Update an existing application_profile.

Request
path Parameters
application_profile_id
required
string

ID of Application profile to use.

header Parameters
Accept
string
Default: application/hal+json
Request Body schema: application/json
fee_profile
object

The ID of the Fee Profile associated with the Application.

risk_profile
object

The ID of the Risk Profile associated with the Application.

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.

(e.g., order number: 25, item_type: produce, department: sales, etc.)

Responses
200

Single application_profile object

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

406

Not Acceptable

put/application_profiles/{application_profile_id}
Request samples 
curl "https://finix.sandbox-payments-api.com/application_profiles/PPqjTEKAmRNGLquQUeLKmXhi" \
  -H "Content-Type: application/json" \
  -H "Finix-Version: 2022-02-01" \
  -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
  -X PUT \
  -d '{}'
Response samples
application/json
{}