Created
December 8, 2023 20:45
-
-
Save jay-babu/c628a8838ce332375c23b94f8da54883 to your computer and use it in GitHub Desktop.
finix swagger
This file has been truncated, but you can view the full file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
openapi: 3.0.2 | |
x-stoplight: | |
id: c6861590dda46 | |
info: | |
title: Finix API | |
contact: | |
name: Finix | |
url: 'https://finix.com' | |
email: support@finixpayments.com | |
version: '2022-02-01' | |
x-ignoredHeaderParameters: | |
- Accept | |
- finix-apiuser-role | |
- date | |
- x-request-id | |
servers: | |
- description: Sandbox server to be used for testing and development | |
url: 'https://finix.sandbox-payments-api.com' | |
tags: | |
- name: Applications | |
x-tagGroups: | |
- name: MAIN RESOURCES | |
tags: | |
- Authorizations | |
- Compliance Forms | |
- Devices | |
- Disputes | |
- Fee Profiles | |
- Files | |
- Identities | |
- Instrument Updates | |
- Merchants | |
- Onboarding Forms | |
- Payment Instruments | |
- Settlements | |
- Split Transfers | |
- Transfers | |
- Users | |
- Webhooks | |
- name: CORE-PAYFAC RESOURCES | |
tags: | |
- Application Profiles | |
- Applications | |
- Balance Transfers | |
- Merchant Profiles | |
- Payout Profiles | |
- Verifications | |
- name: SUBSCRIPTION BILLING | |
tags: | |
- Subscription Schedules | |
- Subscription Amounts | |
- Subscription Enrollments | |
paths: | |
/application_profiles: | |
get: | |
tags: | |
- Application Profiles | |
description: Retrieve a list of `application_profiles`. | |
summary: List Application Profiles | |
operationId: listApplicationProfiles | |
responses: | |
'200': | |
$ref: '#/components/responses/ApplicationProfilesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
x-java-method-name: list | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/application-profiles/list-application-profiles.md | |
x-group-parameters: true | |
'/application_profiles/{application_profile_id}': | |
get: | |
tags: | |
- Application Profiles | |
description: Retrieve the details of an existing `application_profile`. | |
summary: Fetch Application Profile | |
operationId: getApplicationProfile | |
responses: | |
'200': | |
$ref: '#/components/responses/ApplicationProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/application-profiles/fetch-application-profile.md | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/ApplicationProfileId' | |
put: | |
tags: | |
- Application Profiles | |
description: Update an existing `application_profile`. | |
summary: Update Application Profile | |
operationId: updateApplicationProfile | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateApplicationProfileRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/ApplicationProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/application-profiles/update-application-profile.md | |
/applications: | |
post: | |
description: | | |
If created successfully, a 201 response gets returned and adds a location header | |
to the response which refers to the new created `Application`. | |
summary: Create an Application | |
operationId: createApplication | |
requestBody: | |
$ref: '#/components/requestBodies/CreateApplicationRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Application' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/applications/create-application.md | |
get: | |
tags: | |
- Applications | |
description: |- | |
Return a collection of `Applications`. If there are no `Applications`, | |
an empty collection gets returned. | |
summary: List Applications | |
operationId: listApplications | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
responses: | |
'200': | |
$ref: '#/components/responses/ApplicationsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: 'curl: list Applications' | |
source: | | |
curl "https://finix.sandbox-payments-api.com/applications" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
'/applications/{application_id}': | |
get: | |
tags: | |
- Applications | |
description: Retrieve the details of an `Application`. | |
summary: Fetch an Application | |
operationId: getApplication | |
responses: | |
'200': | |
$ref: '#/components/responses/Application' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-names: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/ApplicationId' | |
put: | |
tags: | |
- Applications | |
description: Update an existing `Application`. | |
summary: Update an Application | |
operationId: updateApplication | |
responses: | |
'200': | |
$ref: '#/components/responses/Application' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/applications/update-application.md | |
'/applications/{application_id}/processors': | |
get: | |
description: List all `Processors` enabled for an `Application`. | |
summary: List Application Processors | |
operationId: listApplicationProcessors | |
responses: | |
'200': | |
$ref: '#/components/responses/ProcessorsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listByApplicationId | |
x-group-parameters: true | |
tags: | |
- Processors | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32/processors" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/ApplicationId' | |
post: | |
tags: | |
- Processors | |
description: | | |
Enable a `Processor` for an `Application`. If created successfully, a | |
201 status is returned with a location header added to the response which refers to the | |
newly enabled processor. | |
summary: Create Application Processor | |
operationId: createApplicationProcessor | |
requestBody: | |
$ref: '#/components/requestBodies/CreateProcessorRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Processor' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/processors/create-application-processor.md | |
'/applications/{application_id}/processors/{type}': | |
get: | |
description: Get the `Processors` for an `Application` by `type`. | |
summary: Fetch Application Processors | |
operationId: getApplicationProcessor | |
responses: | |
'200': | |
$ref: '#/components/responses/Processor' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
tags: | |
- Processors | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/applications/APdHjTsAPx81go7ekSMJqQdz/processors/DUMMY_V1" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/ApplicationId' | |
- description: Type of `Processor`. | |
required: true | |
in: path | |
name: type | |
schema: | |
type: string | |
'/applications/{application_id}/users': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/ApplicationId' | |
post: | |
description: |- | |
Creating an application user is the equivalent of provisioning API keys (i.e. credentials) for an `Application`. | |
> Each Application can have multiple `Users` which allows each seller to have multiple API keys that can be independently enabled and disabled. Merchants only have read access to the API. | |
summary: Create an Application User | |
operationId: createApplicationUser | |
requestBody: | |
$ref: '#/components/requestBodies/CreateUserRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/User' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
tags: | |
- Users | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/users/create-user.md | |
/authorizations: | |
post: | |
tags: | |
- Authorizations | |
description: |- | |
Create an `Authorization` to process a transaction. | |
Related Guides: [Creating and Capturing an Authorization](/guides/payments/making-a-payment/creating-and-capturing-an-authorization/), [Level 2 and 3 Processing](/guides/payments/making-a-payment/level-2-and-level-3-processing/), [In-Person Cloud Payments](/guides/payments/in-person-payments/cloud/in-person-cloud-payments/), [Buyer Charges](/guides/payments/making-a-payment/buyer-charges/) | |
summary: Create an Authorization | |
operationId: createAuthorization | |
requestBody: | |
$ref: '#/components/requestBodies/CreateAuthorizationRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Authorization' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'402': | |
$ref: '#/components/responses/ErrorPaymentRequired' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Authorizations | |
description: 'Retrieve a list of `Authorizations`. ' | |
summary: List Authorizations | |
operationId: listAuthorizations | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryAmountFilter' | |
- $ref: '#/components/parameters/QueryAmountGtFilter' | |
- $ref: '#/components/parameters/QueryAmountGteFilter' | |
- $ref: '#/components/parameters/QueryAmountLtFilter' | |
- $ref: '#/components/parameters/QueryAmountLteFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryIdempotencyIdFilter' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/TagsKey' | |
- $ref: '#/components/parameters/TagsValue' | |
- in: query | |
name: state | |
description: Filter by Transaction state. | |
schema: | |
enum: | |
- SUCCEEDED | |
- FAILED | |
- PENDING | |
- CANCELED | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryTraceIdFilter' | |
- $ref: '#/components/parameters/QueryVoidFilter' | |
- in: query | |
name: instrument_bin | |
description: Filter by Bank Identification Number (BIN). The BIN is the first 6 digits of the masked number. | |
schema: | |
type: string | |
- schema: | |
type: string | |
in: query | |
name: instrument_account_last4 | |
description: "Filter Transactions by the last 4 digits of the bank account. The bank account last 4 are the last 4 digits of the masked number\tinstrument_account_last4=9444 BIN." | |
- schema: | |
type: string | |
in: query | |
name: instrument_brand_type | |
description: Filter by card brand. Available card brand types can be found in the drop-down. | |
- schema: | |
type: string | |
in: query | |
name: merchant_identity_id | |
description: Filter by `Identity` ID. | |
- schema: | |
type: string | |
in: query | |
name: merchant_identity_name | |
description: Filter Transactions by `Identity` name. The name is not case-sensitive. | |
- schema: | |
type: string | |
in: query | |
name: instrument_name | |
description: Filter Transactions by `Payment Instrument` name. | |
- schema: | |
type: string | |
in: query | |
name: instrument_type | |
description: 'Filter Transactions by `Payment Instrument` type. Available instrument types include: Bank Account or Payment Card.' | |
- schema: | |
type: string | |
in: query | |
name: merchant_id | |
description: Filter by `Merchant` ID. | |
- schema: | |
type: string | |
in: query | |
name: merchant_mid | |
description: Filter by Merchant Identification Number (MID). | |
- schema: | |
type: string | |
in: query | |
name: instrument_card_last4 | |
description: Filter by the payment card last 4 digits. | |
- schema: | |
type: string | |
in: query | |
name: merchant_processor_id | |
description: Filter by `Processor` ID. | |
- schema: | |
type: string | |
in: query | |
name: type | |
description: Type of the `Authorization`. | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
responses: | |
'200': | |
$ref: '#/components/responses/AuthorizationsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/authorizations" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/authorizations/{authorization_id}': | |
get: | |
tags: | |
- Authorizations | |
description: Retrieve the details of a previously created `Authorization`. | |
summary: Fetch an Authorization | |
operationId: getAuthorization | |
responses: | |
'200': | |
$ref: '#/components/responses/Authorization' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/authorizations/AUsCN6f7qTLzxUD3Bp6iXQMQ" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- $ref: '#/components/parameters/AuthorizationId' | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
put: | |
tags: | |
- Authorizations | |
description: |- | |
Use a PUT request to capture an `Authorization`. If captured successfully, the `transfer` field of the `Authorization` will contain the ID of the `Transfer` resource that moves funds. | |
Related Guides: [Creating and Capturing an Authorization](/guides/payments/making-a-payment/creating-and-capturing-an-authorization/), [Level 2 and 3 Processing](/guides/payments/making-a-payment/level-2-and-level-3-processing/), [In-Person Cloud Payments](/guides/payments/in-person-payments/cloud/in-person-cloud-payments/), [Buyer Charges](/guides/payments/making-a-payment/buyer-charges/) | |
summary: Capture an Authorization | |
operationId: captureAuthorization | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateAuthorizationRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/AuthorizationUpdated' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-internal: false | |
x-java-method-name: update | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/authorizations/{authorization_id_void_to}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: authorization_id_void_to | |
in: path | |
required: true | |
put: | |
tags: | |
- Authorizations | |
description: |- | |
Use a PUT request to void an `Authorization`. If voided successfully, funds get released and the transaction stops from completing. Additionally, voided `Authorization` can no longer be captured. | |
Related Guides: [Creating and Capturing an Authorization](/guides/payments/making-a-payment/creating-and-capturing-an-authorization/), [Level 2 and 3 Processing](/guides/payments/making-a-payment/level-2-and-level-3-processing/), [In-Person Cloud Payments](/guides/payments/in-person-payments/cloud/in-person-cloud-payments/), [Buyer Charges](/guides/payments/making-a-payment/buyer-charges/) | |
summary: Void an Authorization | |
operationId: voidAuthorization | |
requestBody: | |
$ref: '#/components/requestBodies/VoidAuthorizationRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/AuthorizationUpdated' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-internal: false | |
x-java-method-name: update | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
/balance_transfers: | |
post: | |
summary: Create a Balance Transfer | |
operationId: createBalanceTransfer | |
responses: | |
'201': | |
$ref: '#/components/responses/BalanceTransfer' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Create a `balance_transfer`. | |
tags: | |
- Balance Transfers | |
requestBody: | |
$ref: '#/components/requestBodies/CreateBalanceTransferRequest' | |
x-internal: false | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/balance-transfer/create-balance-transfer.md | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
get: | |
summary: List Balance Transfers | |
operationId: listBalanceTransfers | |
responses: | |
'200': | |
$ref: '#/components/responses/BalanceTransferList' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
description: Not Found | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Retrieve a list of `balance_transfers`. | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- schema: | |
type: integer | |
in: query | |
name: pageNumber | |
description: The page number to list. | |
- schema: | |
type: integer | |
in: query | |
name: pageSize | |
description: The size of the page. | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryIdempotencyIdFilter' | |
- $ref: '#/components/parameters/QueryAmountFilter' | |
- in: query | |
name: description | |
schema: | |
type: string | |
description: Filter by the `Description` value . | |
- schema: | |
type: string | |
in: query | |
name: destination | |
description: Filter by the `Payment Instrument` saved in `Destination`. | |
- schema: | |
type: string | |
in: query | |
name: external_reference_id | |
description: Filter by the value saved in `external_reference_id`. | |
- schema: | |
type: string | |
in: query | |
name: reference_id | |
description: Filter by the value saved in `reference_id`. | |
- schema: | |
type: string | |
in: query | |
description: Filter by the `Payment Instrument` saved in `source`. | |
name: source | |
tags: | |
- Balance Transfers | |
x-internal: false | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/balance_transfers/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USbkjk46XqUTQHN3i2jaVnc1:ac915962-2757-49ea-aeee-10960a408b99 | |
'/balance_transfers/{balance_transfers_id}': | |
parameters: | |
- schema: | |
type: string | |
name: balance_transfers_id | |
in: path | |
required: true | |
description: ID of the `balance_transfer` resource. | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
get: | |
summary: Fetch a Balance Transfer | |
tags: | |
- Balance Transfers | |
responses: | |
'200': | |
$ref: '#/components/responses/BalanceTransfer' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getBalanceTransfers | |
description: Retrieve the details of a `balance_transfer`. | |
x-internal: false | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/balance_transfers/BT_9SLA5BdQs6Z3xFpmjUoqhM" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USbkjk46XqUTQHN3i2jaVnc1:ac915962-2757-49ea-aeee-10960a408b99 | |
'/devices/{device_id}': | |
put: | |
description: |- | |
Initiate an action on a `Device`. Actions that are available include: | |
- Activating the `Device` | |
- Rebooting the `Device` | |
- Setting an idle message | |
- Deactivating the `Device` | |
You can also use a PUT request to update the `configuration_details`, `description`, `name`, and `serial_number` of the `Device`. | |
summary: Initiate Action on Device | |
operationId: updateDevice | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateDeviceRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/Device' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
tags: | |
- Devices | |
parameters: | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
get: | |
description: Retrieve the details of an existing `Device`. | |
summary: Fetch a Device | |
operationId: getDevice | |
responses: | |
'200': | |
$ref: '#/components/responses/Device' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
parameters: | |
- schema: | |
type: boolean | |
in: query | |
name: include_connection | |
description: Specifies whether the connection information should be included. | |
x-group-parameters: true | |
tags: | |
- Devices | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USjHFGYvecE4LBitYG8KDE2g:b698f403-d9b7-4157-82d8-162cea8c8cc3 | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of the `Device`. | |
required: true | |
in: path | |
name: device_id | |
schema: | |
type: string | |
'/devices/{device_id_connection}': | |
get: | |
description: 'To check the connection of the `Device`, include `?include_connection\=true\` at the end of the request endpoint.' | |
summary: Check Device Connection | |
operationId: getDeviceConnection | |
responses: | |
'200': | |
$ref: '#/components/responses/Device' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
parameters: | |
- schema: | |
type: boolean | |
in: query | |
name: include_connection | |
description: Specifies whether the connection information should be included. | |
required: true | |
x-group-parameters: true | |
tags: | |
- Devices | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f?include_connection=true" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USjHFGYvecE4LBitYG8KDE2g:b698f403-d9b7-4157-82d8-162cea8c8cc3 | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: device_id_connection | |
in: path | |
required: true | |
/disputes: | |
get: | |
tags: | |
- Disputes | |
description: Retrieve a list of `Disputes`. | |
summary: List Disputes | |
operationId: listDisputes | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- schema: | |
type: string | |
in: query | |
name: transfer_id | |
description: 'Filter by the ID of the `Transfer` that''s being disputed. <br><br>**Note**: If included, all other filter parameters are ignored.' | |
- schema: | |
type: string | |
in: query | |
name: adjustment_transfer_id | |
description: 'Filter by the ID of the adjustment `Transfer`. <br><br>**Note**: If included, all other filter parameters are ignored.' | |
- $ref: '#/components/parameters/QueryAmountFilter' | |
- $ref: '#/components/parameters/QueryAmountGteFilter' | |
- $ref: '#/components/parameters/QueryAmountGtFilter' | |
- $ref: '#/components/parameters/QueryAmountLtFilter' | |
- schema: | |
type: string | |
in: query | |
name: state | |
description: Filter by the state of the `Dispute`. | |
- schema: | |
type: string | |
in: query | |
name: response_state | |
description: Filter by the `response_state` of the `Dispute`. | |
- schema: | |
type: string | |
in: query | |
name: respond_by.lte | |
description: Filter where `respond_by` is before the given date. | |
- schema: | |
type: string | |
in: query | |
name: respond_by.gte | |
description: Filter where `respond_by` is after the given date. | |
- schema: | |
type: string | |
in: query | |
name: instrument_bin | |
description: Filter by the Bank Identification Number (BIN). The BIN is the first 6 digits of the masked account number. | |
- schema: | |
type: string | |
in: query | |
name: instrument_brand_type | |
description: Filter by the card brand used. | |
- in: query | |
name: merchant_identity_id | |
description: Filter by the ID of the `Identity` used by the `Merchant`. | |
schema: | |
type: string | |
- schema: | |
type: string | |
in: query | |
name: merchant_identity_name | |
description: Filter by the name used by the `Merchant`. | |
- schema: | |
type: string | |
in: query | |
name: instrument_name | |
description: Filter by the name of the `Payment Instrument`. | |
- schema: | |
type: string | |
in: query | |
name: instrument_type | |
description: Filter by `Payment Instrument` type. | |
- schema: | |
type: string | |
in: query | |
name: merchant_id | |
description: Filter by the ID of the `Merchant`. | |
- schema: | |
type: string | |
in: query | |
name: merchant_mid | |
description: Filter by the MID of the `Merchant`. | |
- schema: | |
type: string | |
in: query | |
name: instrument_card_last4 | |
description: Filter by the last 4 digits of the card used. | |
- schema: | |
type: string | |
in: query | |
name: instrument_card_type | |
description: Filter by the card type. | |
- schema: | |
type: string | |
in: query | |
name: instrument_fingerprint | |
description: Filter by the fingerprint of the `Payment Instrument`. | |
- schema: | |
type: string | |
in: query | |
name: before_cursor | |
description: Returns every `Dispute` created before the cursor value. | |
- $ref: '#/components/parameters/TagsKey' | |
- $ref: '#/components/parameters/TagsValue' | |
responses: | |
'200': | |
$ref: '#/components/responses/DisputesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/disputes/{dispute_id}': | |
get: | |
tags: | |
- Disputes | |
description: Retrieve the details of a previously created `Dispute`. | |
summary: Fetch a Dispute | |
operationId: getDispute | |
responses: | |
'200': | |
$ref: '#/components/responses/Dispute' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Dispute`. | |
required: true | |
in: path | |
name: dispute_id | |
schema: | |
type: string | |
put: | |
summary: Update a Dispute | |
operationId: updateDispute | |
responses: | |
'200': | |
$ref: '#/components/responses/Dispute' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Update `tags` on `Disputes`. | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateDisputeEvidence' | |
x-java-method: put | |
tags: | |
- Disputes | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/disputes/{dispute_id}/evidence': | |
post: | |
tags: | |
- Disputes | |
description: |- | |
Upload a file as evidence for a `Dispute`. | |
- You can upload up to 8 files; the total size of the uploaded files combined cannot exceed 10 MB. | |
- The allowed file formats include JPG, PNG, PDF, or TIFF. | |
- Individual PNG and JPEG files can't exceed 50 KB; PDF and TIFF files can't exceed 1 MB. | |
summary: Upload Files as Dispute Evidence | |
operationId: createDisputeEvidence | |
responses: | |
'201': | |
$ref: '#/components/responses/DisputeEvidence' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/disputes/uploadevidence.md | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
requestBody: | |
$ref: '#/components/requestBodies/CreateDisputeEvidenceRequest' | |
get: | |
tags: | |
- Disputes | |
description: Retrieve a list of dispute evidence for a `Dispute`. | |
summary: List Dispute Evidence | |
operationId: listDisputeEvidence | |
responses: | |
'200': | |
$ref: '#/components/responses/DisputeEvidenceList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listDisputeEvidenceByDisputeId | |
x-group-parameters: true | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Dispute` to mange evidence for. | |
required: true | |
in: path | |
name: dispute_id | |
schema: | |
type: string | |
'/disputes/{dispute_id}/evidence/{evidence_id}': | |
get: | |
tags: | |
- Disputes | |
description: |- | |
Fetch evidence uploaded for a `Dispute`. | |
If you don't have the Finix Dashboard available, you can fetch the evidence to review the `status` of the upload to confirm the evidence got sent to the processor. | |
summary: Fetch Dispute Evidence | |
operationId: getDisputeEvidence | |
responses: | |
'200': | |
$ref: '#/components/responses/DisputeEvidence' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DF58kdVTa5eMQUjcXH2F7DH4" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Dispute` to fetch evidence for. | |
required: true | |
in: path | |
name: dispute_id | |
schema: | |
type: string | |
- description: ID of `evidence` to fetch. | |
required: true | |
in: path | |
name: evidence_id | |
schema: | |
type: string | |
put: | |
summary: Update Dispute Evidence | |
operationId: updateDisputeEvidence | |
responses: | |
'200': | |
$ref: '#/components/responses/DisputeEvidence' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Update tags on `Dispute` evidence. | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateDisputeEvidence' | |
x-java-method: put | |
tags: | |
- Disputes | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
/fee_profiles: | |
get: | |
description: List all `Fee Profiles`. | |
summary: List Fee Profiles | |
operationId: listFeeProfiles | |
responses: | |
'200': | |
$ref: '#/components/responses/FeeProfilesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
tags: | |
- Fee Profiles | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/fee_profiles" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
post: | |
description: Create a `fee_profile`. | |
summary: Create a Fee Profile | |
operationId: createFeeProfile | |
requestBody: | |
$ref: '#/components/requestBodies/CreateFeeProfileRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/FeeProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/fee-profiles/create-fee-profile.md | |
tags: | |
- Fee Profiles | |
'/fee_profiles/{fee_profile_id}': | |
get: | |
description: Get a `fee_profile`. | |
summary: Fetch a Fee Profile | |
operationId: getFeeProfile | |
responses: | |
'200': | |
$ref: '#/components/responses/FeeProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
tags: | |
- Fee Profiles | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/fee_profiles/FPq6PQ9pHsab66fKMmjQ7jb5" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- required: true | |
in: path | |
name: fee_profile_id | |
schema: | |
type: string | |
description: The ID of the `fee_profile`. | |
/fees: | |
get: | |
tags: | |
- Fees | |
description: Return a collection of `fees`. | |
summary: List Fees | |
operationId: listFees | |
responses: | |
'200': | |
$ref: '#/components/responses/FeesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryOffset' | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/fees" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
x-internal: true | |
post: | |
summary: Create a One-Time Fee | |
tags: | |
- Fees | |
operationId: create-fees | |
responses: | |
'201': | |
$ref: '#/components/responses/Fee' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Create a custom (i.e. one time) `fee`. | |
requestBody: | |
$ref: '#/components/requestBodies/CreateFeeRequest' | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/fees/one-time-fee.md | |
x-internal: true | |
'/fees/{fee_id}': | |
get: | |
tags: | |
- Fees | |
description: Retrieve the details of a `fee`. | |
summary: Fetch a Fee | |
operationId: getFee | |
responses: | |
'200': | |
$ref: '#/components/responses/Fee' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/fees/FEtSD9oNjoCtJaN2C1FwhZ29" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
x-internal: true | |
parameters: | |
- $ref: '#/components/parameters/FeeId' | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
put: | |
summary: Update Fee | |
operationId: updateFee | |
responses: | |
'200': | |
$ref: '#/components/responses/Fee' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateFeeRequest' | |
description: Update the details of a `fee`. | |
tags: | |
- Fees | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/fees/update-fee.md | |
x-internal: true | |
/identities: | |
post: | |
tags: | |
- Identities | |
description: |- | |
Create an `Identity` for your seller or buyer. | |
All fields for a buyer's `Identity` are optional. | |
Providing `business_type` indicates that the `Identity` is being created for a Merchant. | |
Related Guides: [Getting Started](/guides/getting-started/), [Onboarding](/guides/onboarding/) | |
summary: Create an Identity | |
operationId: createIdentity | |
requestBody: | |
$ref: '#/components/requestBodies/CreateIdentityRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Identity' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Identities | |
description: Retrieve a list of `Identities`. | |
summary: List Identities | |
operationId: listIdentities | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryDefaultStatementDescriptorFilter' | |
- $ref: '#/components/parameters/QueryBusinessName' | |
- $ref: '#/components/parameters/QueryBusinessType' | |
- $ref: '#/components/parameters/QueryEmail' | |
- $ref: '#/components/parameters/QueryFirstName' | |
- $ref: '#/components/parameters/QueryLastName' | |
- $ref: '#/components/parameters/QueryTitle' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/TagsKey' | |
- $ref: '#/components/parameters/TagsValue' | |
responses: | |
'200': | |
$ref: '#/components/responses/IdentitiesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/identities" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/identities/{identity_id}': | |
get: | |
tags: | |
- Identities | |
description: Retrieve the details of a previously created `Identity`. | |
summary: Fetch an Identity | |
operationId: getIdentity | |
responses: | |
'200': | |
$ref: '#/components/responses/Identity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of the `Identity` to fetch. | |
required: true | |
in: path | |
name: identity_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Identities | |
description: |- | |
Update an existing `Identity`. | |
If you are updating the `Identity` of a `Merchant` that’s already been onboarded, you need to [verify the merchant again](/api/tag/Merchants/#tag/Merchants/operation/createMerchantVerification). | |
summary: Update an Identity | |
operationId: updateIdentity | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateIdentityRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/Identity' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/identities/updateidentity.md | |
'/identities/{identity_id}/associated_identities': | |
post: | |
tags: | |
- Identities | |
description: 'Create an associated `Identity` for [every owner with 25% or more ownership](/guides/onboarding/onboarding-with-api#step-3-add-associated-identities) over the merchant.' | |
summary: Create an Associated Identity | |
operationId: createAssociatedIdentity | |
requestBody: | |
$ref: '#/components/requestBodies/CreateAssociatedIdentityRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Identity' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: createAssociatedIdentity | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/identities/IDgXNAaoy5d4TLkp5ze6gScA/associated_identities" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
-d ' | |
{ | |
"entity": { | |
"first_name": "John", | |
"last_name": "Smith", | |
"title": "Founder", | |
"dob": { | |
"month": 1, | |
"day": 1, | |
"year": 2013 | |
}, | |
"principal_percentage_ownership": 25, | |
"phone": "14158885080", | |
"personal_address": { | |
"city": "San Francisco", | |
"region": "CA", | |
"postal_code": "90650", | |
"line1": "123 Main Street", | |
"country": "USA" | |
}, | |
"email": "john.smith@company1.com", | |
"tax_id": "123456789" | |
} | |
}' | |
get: | |
tags: | |
- Identities | |
description: Retrieve a list of `Associated Identities` for an `Identity`. | |
summary: List Associated Identities | |
operationId: listIdentityAssociatedIdentities | |
parameters: | |
- required: false | |
in: query | |
name: limit | |
schema: | |
type: integer | |
format: int64 | |
description: The number of entries to return. | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/IdentitiesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listAssociatedIdentities | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/identities/IDf33pdVaTZGXVFNccdKvaPu/associated_identities" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Identity` to associate object with. | |
required: true | |
in: path | |
name: identity_id | |
schema: | |
type: string | |
'/identities/{identity_id}/merchants': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Identity` to fetch. | |
required: true | |
in: path | |
name: identity_id | |
schema: | |
type: string | |
post: | |
description: |- | |
Create a `Merchant` to start the underwriting (also called provisioning) process for your seller. `Merchants` must be created under an [`Identity`](/api/tag/Identities). | |
A bank account must be associated with the previously created `Identity` before a `Merchant` can be successfully onboarded and verified. | |
summary: Create a Merchant | |
operationId: createMerchant | |
requestBody: | |
$ref: '#/components/requestBodies/CreateMerchantUnderwritingRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Merchant' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
tags: | |
- Merchants | |
x-java-method-name: create | |
parameters: | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/identities/{identity_id}/settlements': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: 'ID of the `Identity` for the merchant you want to settle. ' | |
required: true | |
in: path | |
name: identity_id | |
schema: | |
type: string | |
post: | |
description: |- | |
Close the currently accruing `settlement`. | |
Finix, by default, creates accruing `settlements` then closes them based on your payout configurations. Use this endpoint to manually close the currently accruing settlement. | |
The closed `Settlement` will not accrue any further transactions and gets immediately submitted for approval. | |
- This endpoint is only available to Finix Core customers. If you have any questions, please contact the [Finix Support Team.](mailto:support@finixpayments.com) | |
- Any refunded `Transfers` get included in `Settlements` as a deduction. | |
- **PENDING** `Transfers` don't get included in `Settlements`. | |
- The `total_amount` minus the `total_fee` equals the `net_amount`. The `net_amount` is the amount in cents that gets deposited into the seller's bank account. | |
Related Guides: [Accruing Settlements](/guides/payouts/accruing-settlements/#closing-an-accruing-settlement) | |
summary: Close Current Active Settlement | |
operationId: createIdentitySettlement | |
requestBody: | |
$ref: '#/components/requestBodies/CreateIdentitySettlementRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Settlement' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/ErrorMerchantIdentityDisabled' | |
x-internal: false | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/settlements/closesettlement.md | |
'/identities/{identity_id}/verifications': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Identity` to verify. | |
required: true | |
in: path | |
name: identity_id | |
schema: | |
type: string | |
post: | |
summary: Verify an Identity | |
operationId: createIdentityVerification | |
responses: | |
'201': | |
$ref: '#/components/responses/Verification' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Verify an `Identity`. | |
requestBody: | |
$ref: '#/components/requestBodies/CreateVerificationRequest' | |
tags: | |
- Identities | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/identities/verifyidentity.md | |
x-internal: true | |
/merchant_profiles: | |
get: | |
tags: | |
- Merchant Profiles | |
description: Retireve a list of all `merchant_profiles`. | |
summary: List Merchant Profiles | |
operationId: listMerchantProfiles | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/MerchantProfilesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchant_profiles" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
/merchants: | |
get: | |
tags: | |
- Merchants | |
description: 'Retrieve a list of `Merchants`. ' | |
summary: List Merchants | |
operationId: listMerchants | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
responses: | |
'200': | |
$ref: '#/components/responses/MerchantsList' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchants" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/merchants/{merchant_id}/devices': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of the `Merchant` object. | |
required: true | |
in: path | |
name: merchant_id | |
schema: | |
type: string | |
post: | |
description: Create a `Device` under a `Merchant`. | |
summary: Create a Device | |
operationId: createMerchantDevice | |
responses: | |
'200': | |
$ref: '#/components/responses/Device' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
tags: | |
- Devices | |
requestBody: | |
$ref: '#/components/requestBodies/CreateDeviceRequest' | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/devices/create-device.md | |
'/merchants/{merchant_id}': | |
get: | |
tags: | |
- Merchants | |
description: Retrieve the details of a `Merchant`. | |
summary: Fetch a Merchant | |
operationId: getMerchant | |
responses: | |
'200': | |
$ref: '#/components/responses/Merchant' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchants/MUmUL7aBsHkxVLQawJxEXw6N" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Merchant`. | |
required: true | |
in: path | |
name: merchant_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Merchants | |
description: |- | |
Update a `Merchant` to: | |
- Change the `Identity` information saved with the underlying processor | |
- [Enable Level 2/3 processing](/guides/payments/making-a-payment/level-2-and-level-3-processing/) | |
- Enable [buyer charges](/guides/payments/making-a-payment/buyer-charges/) | |
- Enable partial authorizations | |
- Disable a `Merchant` so the seller can't create new `Transfers` and `Authorizations` | |
summary: Update a Merchant | |
operationId: updateMerchant | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateMerchantRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/MerchantUpdated' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/merchant_profiles/{merchant_profile_id}': | |
get: | |
tags: | |
- Merchant Profiles | |
description: Retrieve the details of a previosuly created `merchant_profile`. | |
summary: Fetch a Merchant Profile | |
operationId: getMerchantProfile | |
responses: | |
'200': | |
$ref: '#/components/responses/MerchantProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchant_profiles/MPsdo8WPP5erWzfPwMjYjVy3" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `merchant_profile`. | |
required: true | |
in: path | |
name: merchant_profile_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Merchant Profiles | |
description: Update a `merchant_profile`. | |
summary: Update a Merchant Profile | |
operationId: updateMerchantProfile | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateMerchantProfileRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/MerchantProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/merchant-profiles/update-merchant-profile.md | |
x-internal: false | |
'/merchants/{merchant_id}/verifications': | |
get: | |
description: Get a list of all the `Verifications` for a `Merchant` resource. | |
summary: List Merchant Verifications | |
operationId: listMerchantVerifications | |
parameters: | |
- required: false | |
in: query | |
name: limit | |
schema: | |
type: integer | |
format: int64 | |
description: The number of entries to return. | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/VerificationsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
x-java-method-name: listByMerchantId | |
x-group-parameters: true | |
tags: | |
- Verifications | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchants/MUpaGK5dUb2Sb7aGuXhFRNbj/verifications" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Merchant` object. | |
required: true | |
in: path | |
name: merchant_id | |
schema: | |
type: string | |
post: | |
tags: | |
- Merchants | |
description: |- | |
Verify a `Merchant` if the `onboarding_state` for a `Merchant` returns **FAILED**, or if the correct the seller needs to update the saved in their information `Identity`. | |
Related Guides: [Onboarding Process](/guides/onboarding/onboarding-process/#reverify-a-merchant) | |
summary: Reverify a Merchant | |
operationId: createMerchantVerification | |
requestBody: | |
$ref: '#/components/requestBodies/CreateMerchantVerificationRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/MerchantPIVerification' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
/payment_instruments: | |
post: | |
tags: | |
- Payment Instruments | |
description: |- | |
Create a `Payment Instrument` resource using a card or bank account. | |
- The creation of `Payment Instruments` directly via Finix's API should only be done for testing purposes. You must use [our hosted fields](/guides/payments/making-a-payment/using-hosted-fields/) or the javascript client to remain out of PCI scope. | |
summary: Create a Payment Instrument | |
operationId: createPaymentInstrument | |
requestBody: | |
$ref: '#/components/requestBodies/CreatePaymentInstrumentRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/PaymentInstrument' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Payment Instruments | |
description: Retrieve a list of `Payment Instruments`. | |
summary: List Payment Instruments | |
operationId: listPaymentInstruments | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryAccountLastFour' | |
- $ref: '#/components/parameters/QueryAccountRoutingNumber' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryApplicationFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/QueryBin' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryExpirationMonth' | |
- $ref: '#/components/parameters/QueryExpirationYear' | |
- $ref: '#/components/parameters/QueryLastFour' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryName' | |
- $ref: '#/components/parameters/QueryOwnerIdentity' | |
- $ref: '#/components/parameters/QueryPaymentInstrumentType' | |
- $ref: '#/components/parameters/TagsKey' | |
- $ref: '#/components/parameters/TagsValue' | |
responses: | |
'200': | |
$ref: '#/components/responses/PaymentInstrumentsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payment_instruments" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/payment_instruments/{payment_instrument_id}': | |
get: | |
tags: | |
- Payment Instruments | |
description: Retrieve the details of a `Payment Instrument`. | |
summary: Fetch a Payment Instrument | |
operationId: getPaymentInstrument | |
responses: | |
'200': | |
$ref: '#/components/responses/PaymentInstrument' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of object | |
required: true | |
in: path | |
name: payment_instrument_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Payment Instruments | |
description: |- | |
Update a `Payment Instrument` to: | |
- Change the **billing address** in case the account holder moved (`instrument_type`:**PAYMENT_CARD** only). | |
- Disable the `Payment Instrument` resource so it can't be used in requests. | |
- Update the `name` on the `Payment Instrument`. | |
- Change the `tags`. | |
summary: Update a Payment Instrument | |
operationId: updatePaymentInstrument | |
requestBody: | |
$ref: '#/components/requestBodies/UpdatePaymentInstrumentRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/PaymentInstrument' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
parameters: | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/payment_instruments/{payment_instrument_id}/updates': | |
get: | |
description: |- | |
List the updates on a `Payment Instrument`. | |
When using the [account updater](/guides/payments/account-updater), `Payment Instrument` details that are updated are represented by an `Update`. | |
summary: List Payment Instrument Updates | |
operationId: listPaymentInstrumentUpdates | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- required: false | |
in: query | |
name: limit | |
schema: | |
type: integer | |
format: int64 | |
description: The number of entries to return. | |
- required: false | |
in: query | |
name: offset | |
schema: | |
type: integer | |
format: int64 | |
description: The number of items to skip before starting to collect the result set. | |
- required: false | |
in: query | |
name: pageSize | |
schema: | |
type: integer | |
format: int64 | |
description: The size of the page. | |
responses: | |
'200': | |
$ref: '#/components/responses/PaymentInstrumentUpdatesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listUpdatesByPaymentInstrumentId | |
x-group-parameters: true | |
x-internal: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137/updates" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Payment Instrument` object. | |
required: true | |
in: path | |
name: payment_instrument_id | |
schema: | |
type: string | |
'/payment_instruments/{payment_instrument_id_verify}': | |
get: | |
tags: | |
- Verifications | |
description: List all the `Verifications` created for a `Payment Instrument`. | |
summary: List Payment Instrument Verifications | |
operationId: listPaymentInstrumentVerifications | |
parameters: | |
- required: false | |
in: query | |
name: limit | |
schema: | |
type: integer | |
format: int64 | |
description: The number of entries to return. | |
- required: false | |
in: query | |
name: offset | |
schema: | |
type: integer | |
format: int64 | |
description: The number of items to skip before starting to collect the result set. | |
- required: false | |
in: query | |
name: pageNumber | |
schema: | |
type: integer | |
format: int64 | |
description: The page number to list. | |
- required: false | |
in: query | |
name: pageSize | |
schema: | |
type: integer | |
format: int64 | |
description: The size of the page. | |
responses: | |
'200': | |
$ref: '#/components/responses/VerificationsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
x-java-method-name: listByPaymentInstrumentId | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payment_instruments/PImc5nvdnp15atLxEBAGtxJs/verifications/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USpEbizhxFRAFT7oYgWjX87B:6d3ace2c-23f9-4e59-8b75-a1a5b8a53055 | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: payment_instrument_id_verify | |
in: path | |
required: true | |
put: | |
tags: | |
- Payment Instruments P2C | |
- Payment Instruments | |
description: |- | |
Verify a `Payment Instrument` to determine CVV and AVS results. | |
You can also determine Push To Card eligibility for [Push To Card](/guides/push-to-card) customers. | |
summary: Verify a Payment Instrument | |
operationId: createPaymentInstrumentVerification | |
requestBody: | |
$ref: '#/components/requestBodies/CreateVerificationRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Verification' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-jave-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
/settlements: | |
get: | |
tags: | |
- Settlements | |
description: | | |
Retrieve a list of `Settlements`. | |
summary: List All Settlements | |
operationId: listSettlements | |
parameters: | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryAmountFilter' | |
- $ref: '#/components/parameters/QueryAmountGtFilter' | |
- $ref: '#/components/parameters/QueryAmountGteFilter' | |
- $ref: '#/components/parameters/QueryAmountLtFilter' | |
- $ref: '#/components/parameters/QueryAmountLteFilter' | |
- $ref: '#/components/parameters/QueryStatus' | |
- schema: | |
type: string | |
in: query | |
name: transfer_id | |
description: 'Filter by a `transfer_id` a `Settlement` has accrued. Please note this filter is only available for non-versioned requests, or requests using `-H ''Finix-Version: 2018-01-01''`. We''re actively working on making this filter available for later versions. For more details, see [Versioning](/guides/developers/versioning/).' | |
- schema: | |
type: string | |
in: query | |
name: funding_transfer_id | |
description: Filter by a `funding_transfer` a `Settlement` has created. | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
responses: | |
'200': | |
$ref: '#/components/responses/SettlementsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/settlements/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/settlements/{settlement_id}': | |
get: | |
tags: | |
- Settlements | |
description: Retreive the details of a `Settlement`. | |
summary: Fetch a Settlement | |
operationId: getSettlement | |
responses: | |
'200': | |
$ref: '#/components/responses/Settlement' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Settlement` object. | |
required: true | |
in: path | |
name: settlement_id | |
schema: | |
type: string | |
put: | |
summary: Close a Settlement | |
operationId: closesettlements | |
responses: | |
'201': | |
$ref: '#/components/responses/Settlement' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: |- | |
Close an accruing `settlement`. | |
Finix, by default, creates accruing `settlements` then closes them based on your payout configurations. Use this endpoint to manually close a specific `settlement`. | |
The closed `Settlement` will not accrue any further transactions and gets immediately submitted for approval. | |
- This endpoint is only available to Finix Core customers. If you have any questions, please contact the [Finix Support Team](mailto:support@finixpayments.com). | |
- Any refunded `Transfers` get included in `Settlements` as a deduction. | |
- **PENDING** `Transfers` don't get included in `Settlements`. | |
- The `total_amount` minus the `total_fee` equals the `net_amount`. The `net_amount` is the amount in cents that gets deposited into the seller's bank account. | |
requestBody: | |
$ref: '#/components/requestBodies/CloseSettlement' | |
x-java-method-name: put | |
tags: | |
- Settlements | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/settlements/{settlement_id}/funding_transfers': | |
get: | |
tags: | |
- Settlements | |
description: List the funding `Transfers` that were created when a `Settlement` was approved that have `type` **CREDIT** or **DEBIT**. | |
summary: List Settlement Funding Transfers | |
operationId: listSettlementFundingTransfers | |
responses: | |
'200': | |
$ref: '#/components/responses/TransfersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listFundingTransfers | |
x-group-parameters: true | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryLimit' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/settlements/STivxR2KrnVdD75TQtitnsG8/funding_transfers" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Settlement` object. | |
required: true | |
in: path | |
name: settlement_id | |
schema: | |
type: string | |
'/settlements/{settlement_id}/transfers': | |
delete: | |
tags: | |
- Settlements | |
description: |- | |
Remove a `Transfer` that makes up a `Settlement`. | |
As long as the `Settlement` hasn't been funded, you can remove the `Transfer` or an array of `Transfers`, along with its corresponding `fee` from the encompassing `Settlement`. | |
- Funding `transfers` can't be deleted. | |
> Per the JSON API for deleting a resource, our API doesn't have a response body when removing a `Transfer` from a `Settlement`. | |
summary: Delete Settlement Transfers | |
operationId: removeSettlementTransfers | |
responses: | |
'204': | |
$ref: '#/components/responses/NoContent' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-internal: false | |
x-java-method-name: removeTransfersFromSettlement | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/settlements/deletesettlement.md | |
requestBody: | |
$ref: '#/components/requestBodies/RemoveSettlementTransfer' | |
get: | |
description: Retrieve a list of every `Transfer` in a `Settlement` that has `type` **DEBIT** or **REFUND**. | |
summary: List all Transfers in a Settlement | |
operationId: listSettlementTransfers | |
responses: | |
'200': | |
$ref: '#/components/responses/TransfersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-internal: false | |
x-java-method-name: listTransfersBySettlementId | |
x-group-parameters: true | |
tags: | |
- Settlements | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/settlements/STivxR2KrnVdD75TQtitnsG8/transfers" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Settlement` object. | |
required: true | |
in: path | |
name: settlement_id | |
schema: | |
type: string | |
/transfers: | |
post: | |
tags: | |
- Transfers | |
description: Create a `Transfer`. | |
summary: Create a Transfer | |
operationId: createTransfer | |
requestBody: | |
$ref: '#/components/requestBodies/CreateTransferRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Transfer' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'402': | |
$ref: '#/components/responses/ErrorTransfers402' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Transfers | |
description: Retrieve a list of `Transfers`. | |
summary: List Transfers | |
operationId: listTransfers | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAmountFilter' | |
- $ref: '#/components/parameters/QueryAmountGteFilter' | |
- $ref: '#/components/parameters/QueryAmountGtFilter' | |
- $ref: '#/components/parameters/QueryAmountLteFilter' | |
- $ref: '#/components/parameters/QueryAmountLtFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryIdempotencyIdFilter' | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QuerySettlementReadyToSettleAtGteFilter' | |
- $ref: '#/components/parameters/QuerySettlementReadyToSettleAtLteFilter' | |
- in: query | |
name: state | |
description: Filter by Transaction state. | |
schema: | |
enum: | |
- ALL | |
- SUCCEEDED | |
- FAILED | |
- PENDING | |
- CANCELED | |
- $ref: '#/components/parameters/QueryStatementDescriptorFilter' | |
- $ref: '#/components/parameters/QueryTraceIdFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- in: query | |
name: instrument_bin | |
description: Filter by Bank Identification Number (BIN). The BIN is the first 6 digits of the masked number. | |
schema: | |
type: string | |
- schema: | |
type: string | |
in: query | |
name: instrument_account_last4 | |
description: "Filter Transactions by the last 4 digits of the bank account. The bank account last 4 are the last 4 digits of the masked number\tinstrument_account_last4=9444 BIN." | |
- schema: | |
type: string | |
in: query | |
name: instrument_brand_type | |
description: Filter by card brand. Available card brand types can be found in the drop-down. | |
- schema: | |
type: string | |
in: query | |
name: merchant_identity_id | |
description: Filter by `Identity` ID. | |
- schema: | |
type: string | |
in: query | |
name: merchant_identity_name | |
description: Filter Transactions by `Identity` name. The name is not case-sensitive. | |
- schema: | |
type: string | |
in: query | |
name: instrument_name | |
description: Filter Transactions by `Payment Instrument` name. | |
- schema: | |
type: string | |
in: query | |
name: instrument_type | |
description: 'Filter Transactions by `Payment Instrument` type. Available instrument types include: Bank Account or Payment Card' | |
- schema: | |
type: string | |
in: query | |
name: merchant_id | |
description: Filter by `Merchant` ID. | |
- schema: | |
type: string | |
in: query | |
name: merchant_mid | |
description: Filter by Merchant Identification Number (MID). | |
- schema: | |
type: string | |
in: query | |
name: instrument_card_last4 | |
description: Filter by the payment card last 4 digits. | |
- schema: | |
type: string | |
in: query | |
name: merchant_processor_id | |
description: Filter by `Processor` ID. | |
- schema: | |
type: string | |
enum: | |
- ALL | |
- DEBITS | |
- CREDITS | |
- REVERSAL | |
- SETTLEMENT | |
example: REVERSAL | |
in: query | |
name: type | |
description: 'Filter by `Transfer` type. Available type filters include: All, Debits, Refunds, or Credits.' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- $ref: '#/components/parameters/TagsKey' | |
- $ref: '#/components/parameters/TagsValue' | |
responses: | |
'200': | |
$ref: '#/components/responses/TransfersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/transfers" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/transfers/{transfer_id}': | |
get: | |
tags: | |
- Transfers | |
description: Retrieve a `Transfer`. | |
summary: Fetch a Transfer | |
operationId: getTransfer | |
responses: | |
'200': | |
$ref: '#/components/responses/Transfer' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/transfers/TRvypRNBeqM597Zi4DcqJ2Vh" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Transfer` resource. | |
required: true | |
in: path | |
name: transfer_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Transfers | |
description: Update a `Transfer`. | |
summary: Update a Transfer | |
operationId: updateTransfer | |
responses: | |
'200': | |
$ref: '#/components/responses/Transfer' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateTransferRequest' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/transfers/updatetransfer.md | |
'/transfers/{transfer_id}/reversals': | |
post: | |
tags: | |
- Transfers | |
description: |- | |
Reverse a transfer with a `type` of **DEBIT**. This reversal creates a new `Transfer` resource with a `type` of **REVERSAL**. | |
Related Guides: [Refunding Payments](/guides/after-the-payment/refunding-and-cancelling-payments/) | |
summary: Refund or Reverse a Transfer | |
operationId: createTransferReversal | |
requestBody: | |
$ref: '#/components/requestBodies/CreateReversalRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Transfer' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
parameters: | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Transfers | |
description: Retrieve a list of reversals for a `Transfer`. | |
summary: List Reversals on a Transfer | |
operationId: listTransferReversals | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- required: false | |
in: query | |
name: limit | |
schema: | |
type: integer | |
format: int64 | |
description: The number of entries to return. | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/ReversalsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: listTransfersReversals | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP/reversals" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- description: ID of `Transfer` object. | |
required: true | |
in: path | |
name: transfer_id | |
schema: | |
type: string | |
/users: | |
get: | |
tags: | |
- Users | |
description: Retrieve a list of all `Users`. | |
summary: List all Users | |
operationId: listUsers | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
responses: | |
'200': | |
$ref: '#/components/responses/UsersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/users" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/users/{user_id}': | |
get: | |
tags: | |
- Users | |
description: Retrieve a specific user with the ID of the `User`. | |
summary: Fetch a User by ID | |
operationId: getUser | |
responses: | |
'200': | |
$ref: '#/components/responses/User' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/users/USvVu9MXHz7hVzwDXwbx3UCL" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `User` object. | |
required: true | |
in: path | |
name: user_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Users | |
description: Update a `User` with new tags or disable the `User` and their credentials. | |
summary: Update a User | |
operationId: updateUser | |
responses: | |
'200': | |
$ref: '#/components/responses/User' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateUserRequest' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/users/update-user.md | |
/verifications: | |
post: | |
description: |- | |
Create a `Verification` to verify a seller's `Identity`. | |
Verifications can also be created directly on the resources you want to verify. For example: | |
- `POST /merchants/{merchant_id}/verifications` | |
- `POST /payment_instruments/{payment_instrument_id}/verifications` | |
summary: Create a Merchant Verification | |
operationId: createVerification | |
requestBody: | |
$ref: '#/components/requestBodies/CreateVerificationRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Verification' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/verifications/merchant-verification.md | |
get: | |
tags: | |
- Verifications | |
description: Retrieve a list of `Verifications`. | |
summary: List Verifications | |
operationId: listVerifications | |
parameters: | |
- name: Accept | |
in: header | |
description: Body Header | |
schema: | |
type: string | |
default: application/hal+json | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/VerificationsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/verifications" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/verifications/{verification_id}': | |
get: | |
tags: | |
- Verifications | |
description: Retrieve the details of a `Verification`. | |
summary: Fetch a Verification | |
operationId: getVerification | |
responses: | |
'200': | |
$ref: '#/components/responses/Verification' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/verifications/VIbXwBuccEcqw7rfZneELCv4" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Verification` object. | |
required: true | |
in: path | |
name: verification_id | |
schema: | |
type: string | |
/webhooks: | |
post: | |
tags: | |
- Webhooks | |
description: Create a `Webhook` to specify an endpoint where Finix can send events. | |
summary: Create a Webhook | |
operationId: createWebhook | |
requestBody: | |
$ref: '#/components/requestBodies/CreateWebhookRequest' | |
responses: | |
'201': | |
$ref: '#/components/responses/Webhook' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
get: | |
tags: | |
- Webhooks | |
description: Retrieve a list of `Webhooks`. | |
summary: List Webhooks | |
operationId: listWebhooks | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
responses: | |
'200': | |
$ref: '#/components/responses/WebhooksList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/webhooks" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/webhooks/{webhook_id}': | |
get: | |
tags: | |
- Webhooks | |
description: Retrieve the details of a `Webhook`. | |
summary: Fetch a Webhook | |
operationId: getWebhook | |
responses: | |
'200': | |
$ref: '#/components/responses/Webhook' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/webhooks/WHN6HuqRqTV3mDCxoFLrRvP" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- description: ID of `Webhook` object. | |
required: true | |
in: path | |
name: webhook_id | |
schema: | |
type: string | |
put: | |
tags: | |
- Webhooks | |
description: |- | |
Update an existing `Webhook`to: | |
- Disable or enable an endpoint URL to recieve webhook events. | |
- Add [authentication to a `Webhook`](/guides/developers/webhooks/#authenticating-webhooks). | |
- Filter the [webhook events sent to an endpoint URL](/guides/developers/webhooks/#webhook-event-filtering). | |
summary: Update a Webhook | |
operationId: updateWebhook | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateWebhookRequest' | |
responses: | |
'200': | |
$ref: '#/components/responses/Webhook' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: update | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/subscription/subscription_schedules/{subscription_schedule_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: subscription_schedule_id | |
in: path | |
required: true | |
description: The ID of the `Subscription Schedule`. | |
get: | |
summary: Fetch a Subscription Schedule | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionSchedule' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
description: Not Found | |
'406': | |
description: Not Acceptable | |
operationId: getSubscriptionSchedule | |
description: Retrieve the details of a `subscription_schedule` | |
x-java-method-name: get | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
in: query | |
name: nickname | |
description: Filter by the object's `nickname`. | |
- schema: | |
type: string | |
in: query | |
name: type | |
description: Filter by the object's `subscription_type`. | |
tags: | |
- Subscription Schedules | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uKKHic71ZD9FicJ89mhcNV" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u UStxEci4vXxGDWLQhNvao7YY:25038781-2369-4113-8187-34780e91052e | |
put: | |
summary: Update a Subscription Schedule | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionSchedule' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: updateSubscriptionSchedules | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateSubscriptionScheduleRequest' | |
description: Update the details of a `subscription_schedule`. | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-schedule/update-subscription-schedule.md | |
tags: | |
- Subscription Schedules | |
/subscription/subscription_schedules: | |
get: | |
summary: List Subscription Schedules | |
operationId: listSubscriptionSchedules | |
description: Retrieve a list of `Subscription Schedules`. | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionSchedulesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-java-method-name: list | |
x-group-parameters: true | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
in: query | |
name: nickname | |
description: Filter by the object's `nickname`. | |
- schema: | |
type: string | |
in: query | |
name: type | |
description: Filter by the object's `type`. | |
tags: | |
- Subscription Schedules | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_schedules/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u UStxEci4vXxGDWLQhNvao7YY:25038781-2369-4113-8187-34780e91052e | |
post: | |
summary: Create a Subscription Schedule | |
tags: | |
- Subscription Schedules | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionSchedule' | |
'401': | |
description: Unauthorized | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: post-subscription-subscription_schedules | |
requestBody: | |
$ref: '#/components/requestBodies/CreateSubscriptionScheduleRequest' | |
description: Create a `subscription_schedule`. | |
x-java-method-name: create | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/subscription/subscription_schedules/{subscription_schedule_id}/subscription_amounts': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: subscription_schedule_id | |
in: path | |
required: true | |
description: The ID of the `Subscription Schedule`. | |
get: | |
summary: List Subscription Amounts | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionAmountsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
description: Not Acceptable | |
operationId: listSubscriptionAmount | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
description: Retrive a list of `Subscription Amounts`. | |
x-java-method-name: listBySubscriptionSchedule | |
x-group-parameters: true | |
tags: | |
- Subscription Amounts | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u UStxEci4vXxGDWLQhNvao7YY:25038781-2369-4113-8187-34780e91052e | |
post: | |
summary: Create a Subscription Amount | |
tags: | |
- Subscription Amounts | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionAmount' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: createSubscriptionAmounts | |
requestBody: | |
$ref: '#/components/requestBodies/CreateSubscriptionAmountRequest' | |
description: |- | |
Create a `subscription_amount`. | |
The `Subscription Amount` is the amount to be charged to a `Merchant`. The `Subscription Amount` must be associated to a `Subscription Schedule`. | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-amount/create-sub-amount.md | |
'/subscription/subscription_schedules/{subscription_schedule_id}/subscription_amounts/{subscription_amount_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: subscription_amount_id | |
in: path | |
required: true | |
description: The ID of the `Subscription Amount`. | |
- schema: | |
type: string | |
name: subscription_schedule_id | |
in: path | |
required: true | |
description: The ID of the `Subscription Schedule`. | |
get: | |
summary: Fetch a Subscription Amount | |
tags: | |
- Subscription Amounts | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionAmount' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getSubscriptionAmount | |
description: Retrieve the details of a `subscription_amount`. | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/SUBAMOUNT_7qgPxRxYdRvN4LRXboYoeN" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u UStxEci4vXxGDWLQhNvao7YY:25038781-2369-4113-8187-34780e91052e | |
put: | |
summary: Update a Subscription Amount | |
operationId: updateSubscriptionAmount | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionAmount' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
tags: | |
- Subscription Amounts | |
description: Update the details of a `subscription_amount`. | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-amount/update-sub-amount.md | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateSubscriptionAmountRequest' | |
delete: | |
summary: Delete a Subscription Amount | |
operationId: deleteSubscriptionAmount | |
responses: | |
'204': | |
description: No Content | |
'401': | |
$ref: '#/components/responses/ErrorNotFound' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
tags: | |
- Subscription Amounts | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-amount/delete-sub-amount.md | |
description: |- | |
Delete a previously created `Subscription Amount`. | |
> Per the JSON API for deleting a resource, our API doesn't have a response body when removing a Subsciption Amount. | |
'/subscription/subscription_schedules/{subscription_schedule_id}/subscription_enrollments': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: subscription_schedule_id | |
in: path | |
required: true | |
description: The ID of the `subscription_schedule`. | |
get: | |
summary: List Subscription Enrollments on a Schedule | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionEnrollmentsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
description: Forbidden | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listSubscriptionEnrollmentsInSchedule | |
description: Retrieve a list of `Subscription Enrollments` for a specific `subscription_schedule`. | |
x-java-method-name: listBySubscriptionScheduleId | |
x-group-parameters: true | |
tags: | |
- Subscription Enrollments | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv/subscription_enrollments" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
post: | |
summary: Create a Subscription Enrollment | |
tags: | |
- Subscription Enrollments | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionEnrollment' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: createSubscriptionEnrollments | |
requestBody: | |
$ref: '#/components/requestBodies/CreateSubscriptionEnrollmentRequest' | |
description: |- | |
Create a `subscription_enrollment`. | |
A `subscription_enrollment` details which `Merchant` gets charged, to what schedule, and when the subscription will start. The `subscription_enrollment` must be associated with a `Subscription Schedule`. | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-enrollments/create-sub-enrollment.md | |
/subscription/subscription_enrollments: | |
get: | |
summary: List Subscription Enrollments | |
tags: | |
- Subscription Enrollments | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionEnrollmentsList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listSubscriptionEnrollments | |
description: Retrieve a list of `Subscription Enrollments`. | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_enrollments" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
'/subscription/subscription_enrollments/{subscription_enrollment_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: subscription_enrollment_id | |
in: path | |
required: true | |
description: The ID of the `subscription_enrollment`. | |
put: | |
summary: Update a Subscription Enrollment | |
tags: | |
- Subscription Enrollments | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionEnrollment' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: updateSubscriptionEnrollment | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateSubscriptionEnrollmentRequest' | |
description: Update the details of a `subscription_enrollment`. | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-enrollments/update-sub-enrollment.md | |
get: | |
summary: Fetch a Subscription Enrollment | |
tags: | |
- Subscription Enrollments | |
responses: | |
'200': | |
$ref: '#/components/responses/SubscriptionEnrollment' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getSubscriptionEnrollment | |
description: Retrieve the details of a `subscription_enrollment`. | |
x-java-method-name: get | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
in: query | |
name: merchant | |
description: Filter by the object's `Merchant` ID. | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/subscription/subscription_enrollments/SUBENROLLMENT_Yxwo2Vb6oj97m3PuW9TxQ" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USimz3zSq5R2PqiEBXY6rSiJ:8bacba32-9550-48ff-b567-fe7648947041 | |
delete: | |
summary: Delete a Subscription Enrollment | |
tags: | |
- Subscription Enrollments | |
responses: | |
'204': | |
$ref: '#/components/responses/NoContent' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: deleteSubscriptionEnrollment | |
description: |- | |
Remove a `subscription_enrollment`. | |
> Per the JSON API for deleting a resource, our API doesn't have a response body when removing a Subsciption Enrollment. | |
x-java-method-name: remove | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/subscription-enrollments/delete-sub-enrollment.md | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
/instrument_updates: | |
post: | |
summary: Create Instrument Updates | |
operationId: createPaymentInstrumentUpdate | |
responses: | |
'200': | |
$ref: '#/components/responses/InstrumentUpdate' | |
'400': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: 'To update the card details of your customers, create an `instrument_updates` resource. Include the `Payment Instrument` IDs you want to update in a CSV.' | |
requestBody: | |
$ref: '#/components/requestBodies/CreateInstrumentUpdateRequest' | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
tags: | |
- Instrument Updates | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/instrument-updates/create-instrument-updates.md | |
'/instrument_updates/{instrument_updates_id}/download': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: instrument_updates_id | |
in: path | |
required: true | |
description: The ID of the `instrument_updates` resource. This ID was returned when initially creating the `instrument_updates` object. | |
get: | |
summary: Download Instrument Updates | |
tags: | |
- Instrument Updates | |
responses: | |
'200': | |
description: "The updated `Payment Instruments` will be returned in the following comma seperated format:\n\npayment\\_instrument\\_original,\t| payment\\_instrument_new, |result\n--------------------------- | ---------------------- | -----\nPIlkNdfZibF8a7Prd2teGB1 | PI3aQGaCM5nDMjqyTXcbUJzR| CARD\\_EXPIRATION_UPDATED\nPIJPXW0HZ9lpO1nb6sog5DiX | PIdBHpy7BBSxd2z81VdKpVbT | CARD\\_NOT\\_FOUND\nPI0ovZAS9yfEtgDrZnMaiLvi | PIhXS0jXNTmklyVk91EsohuZ | CONTACT\\_CARDHOLDER\nPInOrrKY3G1U33hGYTQJ8cIY | | CLOSED\\_ACCOUNT\nPIlkAOt5kTVhuuxxbmOi9qn | | INVALID\\_CARD\nPIiRLbbG4i5daypWNzIrq2xD | | NO\\_CHANGE\\_FOUND\nPIy5llZGt6VxlDqbcTgATqeH | \t | UNKNOWN" | |
content: | |
application/json: | |
schema: | |
type: string | |
format: binary | |
examples: | |
Instrument Update: | |
value: 'payment_instrument_original,payment_instrument_new,result PIlkNdfZibF8a7Prd2teGB1,PI3aQGaCM5nDMjqyTXcbUJzR,CARD_EXPIRATION_UPDATED PIJPXW0HZ9lpO1nb6sog5DiX,PIdBHpy7BBSxd2z81VdKpVbT,CARD_NOT_FOUND PIiRLbbG4i5daypWNzIrq2xD,,NO_CHANGE_FOUND PIy5llZGt6VxlDqbcTgATqeH,,UNKNOWN' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: downloadInstrumentUpdate | |
description: |- | |
Fetch a previously created `instrument_updates` resource as a CSV. | |
To fetch the `instrument_updates` resource in JSON, add `?format=json` to the request endpoint. | |
parameters: | |
- $ref: '#/components/parameters/QueryFormat' | |
x-group-parameters: true | |
x-java-method-name: download | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/instrument_updates/IUd2Wzs6jxPJjteva3n19Amu/download" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
/files: | |
post: | |
summary: Create a File | |
operationId: createFiles | |
responses: | |
'200': | |
$ref: '#/components/responses/File' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/files/createfile.md | |
description: |- | |
Before uploading a file, you need to create a `File` resource. | |
Once created, you can [upload](/guides/onboarding/uploading-files-to-finix/#how-to-upload-a-file-to-finix) your file to the new `File` resource. | |
requestBody: | |
$ref: '#/components/requestBodies/CreateFileRequest' | |
tags: | |
- Files | |
x-java-method-name: create | |
get: | |
summary: List All Files | |
tags: | |
- Files | |
responses: | |
'200': | |
$ref: '#/components/responses/FilesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listFiles | |
description: List all the `File` resources you've created. | |
parameters: | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/files" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/files/{file_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: file_id | |
in: path | |
required: true | |
description: Your `File` ID. | |
get: | |
summary: Fetch a File | |
tags: | |
- Files | |
responses: | |
'200': | |
$ref: '#/components/responses/File' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getFile | |
description: Retrieve the details of a `File` resource. | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/files/FILE_abki8bFEjq51eZ5w2pYFik" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/files/{file_id}/external_links': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: file_id | |
in: path | |
required: true | |
description: Your `File` ID. | |
get: | |
summary: List All External Links | |
tags: | |
- Files | |
responses: | |
'200': | |
$ref: '#/components/responses/ExternalLinksList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
description: Not Acceptable | |
operationId: listExternalLinks | |
description: List the previously created `external_links` for a `File`. | |
parameters: | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryIdFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryCreatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtGteFilter' | |
- $ref: '#/components/parameters/QueryUpdatedAtLteFilter' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/files/FILE_abki8bFEjq51eZ5w2pYFik/external_links" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
post: | |
summary: Create an External Link | |
operationId: createExternalLink | |
responses: | |
'200': | |
$ref: '#/components/responses/ExternalLink' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/files/external-link.md | |
description: 'Create an `external_link` resource to share with users so they can upload files directly from their browser. For more info, see [Uploading files to Finix](/guides/onboarding/uploading-files-to-finix/).' | |
requestBody: | |
$ref: '#/components/requestBodies/CreateExternalLinkRequest' | |
tags: | |
- Files | |
'/files/{file_id}/upload': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: file_id | |
in: path | |
required: true | |
description: The ID of the `File` that was created to upload the file. | |
post: | |
summary: Upload files Directly | |
operationId: uploadFile | |
responses: | |
'200': | |
$ref: '#/components/responses/File' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
description: Upload files directly with a `multipart/form-data` request. | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
x-java-method-name: upload | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/files/uploadfile.md | |
tags: | |
- Files | |
requestBody: | |
$ref: '#/components/requestBodies/UploadFileRequest' | |
'/files/{file_id}/download': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: file_id | |
in: path | |
required: true | |
description: The ID of the `File` that was created to upload the file. | |
get: | |
summary: Download a File | |
tags: | |
- Files | |
responses: | |
'200': | |
$ref: '#/components/responses/FileDownload' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: downloadFile | |
x-java-method-name: download | |
description: Download a file that was uploaded to a `File` resource. | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/files/FILE_bJecqoRPasStGPVpvKHtgA/download" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
enum: | |
- 'true' | |
- 'false' | |
in: query | |
name: stream | |
description: Stream the contents of the `File` so it's displayed inline in the user's web browser. | |
'/files/{file_id}/external_links/{external_link_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: file_id | |
in: path | |
required: true | |
description: The ID of the `File` that has the links you want to retrieve. | |
- schema: | |
type: string | |
name: external_link_id | |
in: path | |
required: true | |
description: The ID of the `external_link` that you want to retireve. | |
get: | |
summary: Fetch an External LInk | |
tags: | |
- Files | |
responses: | |
'200': | |
$ref: '#/components/responses/ExternalLink' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getExternalLink | |
description: Fetch a previously created `external_link` resource. | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/files/FILE_bJecqoRPasStEPVpvKHtgA/external_links/EL_dh5YS66GePpkeSVyL4VdBL" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
/apple_pay_sessions: | |
post: | |
summary: Create an Apple Pay Session | |
operationId: createApplePaySession | |
responses: | |
'200': | |
$ref: '#/components/responses/ApplePaySession' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
tags: | |
- Payment Instruments | |
x-java-method-name: createApplePaySession | |
requestBody: | |
$ref: '#/components/requestBodies/CreateApplePaySessionRequest' | |
description: |- | |
Create an `apple_pay_session` to process Apple Pay transactions on the web. | |
To create an Apple Pay Session, pass the unique `validation_url` (provided by Apple) while creating an `apple_pay_sessions` resource. Finix returns a `merchantSession` object that you can use to create a payment. For more information, see [Apple Pay](/guides/payments/alternative-payment-methods/apple-pay/). | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/payment-instruments/createapplepay.md | |
'/disputes/{dispute_id}/adjustment_transfers': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: dispute_id | |
in: path | |
required: true | |
description: ID of the `Dispute` resource. | |
get: | |
summary: Fetch Dispute Adjustment Transfers | |
tags: | |
- Disputes | |
responses: | |
'200': | |
$ref: '#/components/responses/AdjustmentTransfersList' | |
'401': | |
description: Unauthorized | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listDisputesAdjustments | |
description: |- | |
List the adjustment `Transfers` for a `Dispute`. Depending on the stage of the `Dispute`, different adjustment `Transfer` subtypes can be applied. | |
There are four available subtypes for adjustment `Transfers` in `Disputes`: <ul><li><strong>PLATFORM\_CREDIT</strong><li><strong>MERCHANT\_DEBIT</strong><li><strong>MERCHANT\_CREDIT</strong><li><strong>PLATFORM\_DEBIT</strong></ul> | |
x-group-parameters: true | |
parameters: | |
- $ref: '#/components/parameters/QueryLimit' | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryBeforeCursor' | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/instrument_updates/{instrument_updates_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
description: The ID of the `instrument_update`. | |
name: instrument_updates_id | |
in: path | |
required: true | |
get: | |
summary: Fetch an Instrument Update | |
tags: | |
- Instrument Updates | |
responses: | |
'200': | |
$ref: '#/components/responses/InstrumentUpdate' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getInstrumentUpdate | |
description: Fetch a specific `instrument_update` from an `instrument_updates` resource. | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/instrument_updates/IUp9oSWhWUF31DPrJ8CojQeQ/" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
'/compliance_forms/{compliance_forms_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: compliance_forms_id | |
in: path | |
required: true | |
description: ID of the `compliance_form`. | |
get: | |
summary: Fetch a Compliance Form | |
tags: | |
- Compliance Forms | |
responses: | |
'200': | |
$ref: '#/components/responses/ComplianceForm' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getComplianceForms | |
x-java-method-name: list | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/compliance-forms/fetch-compliance-form.md | |
description: |- | |
A webhook notifies you when Finix creates a `compliance_form`. | |
Use the ID in the webhook to fetch the `compliance_form` resource from the `/compliance_forms/:COMPLIANCE_FORM_ID:` endpoint. | |
put: | |
summary: Complete a Compliance Form | |
operationId: updateComplianceForms | |
responses: | |
'200': | |
$ref: '#/components/responses/ComplianceForm' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
description: |- | |
As part of onboarding your users, you'll need to build a UI experience that allows users to complete the PCI `compliance_form` and download the form as a PDF if requested. | |
For more information, see [Managing Compliance Forms](/guides/security-and-compliance/pci-dss-compliance/managing-pci-compliance/#completing-compliance-forms). | |
tags: | |
- Compliance Forms | |
requestBody: | |
$ref: '#/components/requestBodies/UpdateComplianceForm' | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/compliance-forms/complete-compliance-form.md | |
/compliance_forms: | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
get: | |
summary: List Compliance Forms | |
tags: | |
- Compliance Forms | |
responses: | |
'200': | |
$ref: '#/components/responses/ComplianceFormList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listComplianceForms | |
x-java-method-name: list | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/compliance-forms/list-compliance-forms.md | |
description: Retrieves a list of `Compliance Forms`. | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
enum: | |
- INCOMPLETE | |
- COMPLETE | |
in: query | |
name: state | |
description: Filter by the `state` of the `Compliance Form`. | |
/onboarding_forms: | |
post: | |
summary: Create an Onboarding Form | |
operationId: createOnboardingForm | |
responses: | |
'200': | |
$ref: '#/components/responses/OnboardingForm' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
description: |- | |
Create an `onboarding_form` with the name of the processor you plan to onboard users to and the links they` get redirected to when completing or moving away from the Finix Onboarding Form. | |
Only **ROLE_PARTNER** credentials can be used to create an `onboarding_form`. | |
requestBody: | |
$ref: '#/components/requestBodies/CreateOnboardingFormRequest' | |
tags: | |
- Onboarding Forms | |
x-java-method-name: create | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/onboarding-form/create-onboarding-form.md | |
parameters: [] | |
'/onboarding_forms/{onboarding_form_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: onboarding_form_id | |
description: The id of the `onboarding_form`. | |
in: path | |
required: true | |
get: | |
summary: Fetch an Onboarding Form | |
operationId: getOnboardingForm | |
responses: | |
'200': | |
$ref: '#/components/responses/OnboardingForm' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
description: Retrieve the details of an `onboarding_form`. | |
tags: | |
- Onboarding Forms | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/onboarding-form/fetch-onboarding-form.md | |
'/onboarding_forms/{onboarding_form_id}/links': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: onboarding_form_id | |
in: path | |
required: true | |
description: The ID of the `onboarding_form` resource. | |
post: | |
summary: Create an Onboarding Form Link | |
operationId: createOnboardingFormLink | |
responses: | |
'200': | |
$ref: '#/components/responses/OnboardingFormLink' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
description: Use the `onboarding_forms` API to create a link that can return users to where they left off completing their Finix Onboarding Form. | |
requestBody: | |
$ref: '#/components/requestBodies/CreateOnboardingFormLinkRequest' | |
tags: | |
- Onboarding Forms | |
x-java-method-name: createLink | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/onboarding-form/onboarding-form-link.md | |
/payout_profiles: | |
get: | |
summary: List Payout Profiles | |
responses: | |
'200': | |
$ref: '#/components/responses/PayoutProfilesList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
description: Not Acceptable | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
operationId: listPayoutprofiles | |
description: List all `Payout Profiles`. | |
x-java-method-name: list | |
x-group-parameters: true | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payout_profiles" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u US4UKYcdgmg3CKPxDRyV3FtA:88214476-3d56-4708-adc2-a7f001b0d5a1 | |
tags: | |
- Payout Profiles | |
parameters: | |
- $ref: '#/components/parameters/QueryAfterCursor' | |
- $ref: '#/components/parameters/QueryLimit' | |
'/payout_profiles/{payout_profile_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: payout_profile_id | |
in: path | |
required: true | |
description: ID of the `Payout Profile`. | |
get: | |
summary: Fetch a Payout Profile | |
responses: | |
'200': | |
$ref: '#/components/responses/PayoutProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
operationId: getPayoutprofile | |
description: Retrieve the details of a previously created `Payout Profile`. | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/payout_profiles/POf5rP3c3XyRX7M6PuCvmgxf" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u US4UKYcdgmg3CKPxDRyV3FtA:88214476-3d56-4708-adc2-a7f001b0d5a1 | |
tags: | |
- Payout Profiles | |
put: | |
summary: Update a Payout Profile | |
operationId: updatePayoutProfileRequest | |
responses: | |
'200': | |
$ref: '#/components/responses/PayoutProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
description: |- | |
Update a `Payout Profile` to configure how fees and payouts get calculated, credited, and debited. | |
By default, `Merchants` get configured with daily net settlements. Payouts get submitted using the **Next-Day ACH** `rail`. Contact [Finix Support](/guides/getting-started/support-at-finix/) to configure payouts on a custom schedule. | |
requestBody: | |
$ref: '#/components/requestBodies/UpdatePayoutProfileRequest' | |
tags: | |
- Payout Profiles | |
x-java-method-name: update | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/payout-profile/update-payout-profile.md | |
'/merchants/{merchant_id}/payout_profile': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: merchant_id | |
in: path | |
required: true | |
description: ID of the `Merchant`. | |
get: | |
summary: Fetch Payout Profile by Merchant | |
responses: | |
'200': | |
$ref: '#/components/responses/PayoutProfile' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/Error422InvalidField' | |
operationId: fetchPayoutProfilesbyMerchant | |
description: Fetch the the `Payout Profile` createrd for a specific `Merchant`. | |
x-java-method-name: getByMerchantId | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/merchants/MUfbbKm7vRmBX2bP92pKw9zZ/payout_profile" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u US4UKYcdgmg3CKPxDRyV3FtA:88214476-3d56-4708-adc2-a7f001b0d5a1 | |
tags: | |
- Payout Profiles | |
'/disputes/{dispute_id}/submit': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: dispute_id | |
in: path | |
required: true | |
description: ID of `Dispute` to move forward and submit evidence. | |
post: | |
summary: Submit Dispute Evidence | |
operationId: submitDisputeEvidence | |
responses: | |
'200': | |
$ref: '#/components/responses/Dispute' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
tags: | |
- Disputes | |
description: |- | |
You can manually submit evidence to the issuing bank to manually move a dispute forward. Use the `/disputes/DISPUTE_ID/submit` endpoint to submit evidence. Making a POST request lets the issuing bank know the seller has completed submitting evidence and is prepared to move forward with the dispute. | |
Related guides: [Responding to Disputes](/guides/after-the-payment/disputes/responding-disputes/). | |
x-java-method-name: post | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/disputes/submit-dispute-evidence.md | |
requestBody: | |
$ref: '#/components/requestBodies/SubmitDisputeEvidence' | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
default: '2018-01-01' | |
example: '2022-02-01' | |
in: header | |
name: Finix-Version | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
'/disputes/{dispute_id}/accept': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: dispute_id | |
in: path | |
required: true | |
description: ID of `Dispute` to move forward and submit evidence. | |
post: | |
summary: Accept a Dispute | |
operationId: acceptDispute | |
responses: | |
'200': | |
$ref: '#/components/responses/Dispute' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
'422': | |
$ref: '#/components/responses/ErrorUnprocessableEntity' | |
description: | | |
You can accept a `Dispute` to prevent a long (and potentially expensive) process. When you accept a `Dispute`, you concede that the Dispute is not worth challenging or representing. | |
Related guides: [Accepting a Dispute](/guides/after-the-payment/disputes/accepting-disputes/) | |
x-java-method-name: post | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | |
$ref: xcode/curl/disputes/accept-dispute.md | |
requestBody: | |
$ref: '#/components/requestBodies/AcceptDisputeRequest' | |
tags: | |
- Disputes | |
'/disputes/{dispute_id}/evidence/{evidence_id}/download': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
example: DIpCy4sZTx6im6U1ofBBPzdM | |
name: dispute_id | |
in: path | |
required: true | |
description: ID of `Dispute` to download evidence from. | |
- schema: | |
type: string | |
example: DFtiQ1LoNbjBTYiuuxju6tE2 | |
name: evidence_id | |
in: path | |
required: true | |
description: ID of `evidence` to download. | |
get: | |
summary: Download Dispute Evidence | |
tags: | |
- Disputes | |
responses: | |
'200': | |
$ref: '#/components/responses/FileDownload' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: downloadDisputeEvidence | |
description: |- | |
Download a file uploaded as `Dispute Evidence`. | |
**Note**: The file extension included in `output` must match the extension of the original uploaded file. | |
x-java-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/disputes/DIpCy4sZTx6im6U1ofBBPzdM/evidence/DFtiQ1LoNbjBTYiuuxju6tE2/download" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \ | |
--output DFtiQ1LoNbjBTYiuuxju6tE2.png | |
parameters: [] | |
'/split_transfers/{split_transfer_id}': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: split_transfer_id | |
in: path | |
required: true | |
get: | |
summary: Fetch a Split Transfer | |
responses: | |
'200': | |
$ref: '#/components/responses/SplitTransfer' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getSplitTransfer | |
description: |- | |
Fetch a `split_transfer` that was created from a split transaction. | |
For more information, see [Split a Transaction](/docs/guides/payments/modify/split-transactions/). | |
x-jave-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
tags: | |
- Split Transfers | |
parameters: [] | |
'/split_transfers/{split_transfer_id}/fees': | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
name: split_transfer_id | |
in: path | |
required: true | |
get: | |
summary: Fetch Split Transfer Fees | |
responses: | |
'200': | |
$ref: '#/components/responses/TransfersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: getSplitTransferFees | |
description: |- | |
Fetch the fees associated with a `split_transfer`. | |
For more information, see [Split a Transaction](/docs/guides/payments/modify/split-transactions/). | |
x-jave-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q/fees" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
tags: | |
- Split Transfers | |
parameters: [] | |
/split_transfers: | |
parameters: [] | |
get: | |
summary: List Split Transfers | |
responses: | |
'200': | |
$ref: '#/components/responses/SplitTransfersList' | |
'401': | |
$ref: '#/components/responses/ErrorUnauthorized' | |
'403': | |
$ref: '#/components/responses/ErrorForbidden403' | |
'404': | |
$ref: '#/components/responses/ErrorNotFound' | |
'406': | |
$ref: '#/components/responses/Error406NotAcceptable' | |
operationId: listSplitTransfer | |
description: |- | |
Retireve a list of `split_transfers` created for a specifc split `Transfer`. | |
For more information, see [Split a Transaction](/docs/guides/payments/modify/split-transactions/). | |
x-jave-method-name: get | |
x-codeSamples: | |
- lang: cURL | |
label: curl | |
source: | | |
curl "https://finix.sandbox-payments-api.com/split_transfers/split_transfers?parent_transfer_id=TRvQN3v5mhA2Ttc78hzjLV3j" \ | |
-H "Content-Type: application/json" \ | |
-H "Finix-Version: 2022-02-01" \ | |
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e | |
parameters: | |
- name: Accept | |
in: header | |
schema: | |
type: string | |
default: application/hal+json | |
- schema: | |
type: string | |
example: TRvQN3v5mhA2Ttc78hzjLV3j | |
pattern: TRxxxxxxxxxxxxxxxxxxxxxx | |
in: query | |
name: parent_transfer_id | |
description: '**ID** of the parent `Transfer` that was split.' | |
required: true | |
components: | |
headers: | |
date: | |
schema: | |
type: string | |
finix-apiuser-role: | |
schema: | |
type: string | |
enum: | |
- ROLE_ADMIN | |
- ROLE_PLATFORM | |
- ROLE_PARTNER | |
- ROLE_MERCHANT | |
version: | |
description: 'Specify the API version of your request. For more details, see [Versioning.](/guides/developers/versioning/)' | |
schema: | |
type: string | |
default: '2018-01-01' | |
example: 'Finix-Version: 2022-02-01' | |
x-request-id: | |
description: A unique ID for this specific API request attempt. | |
schema: | |
type: string | |
parameters: | |
ApplicationId: | |
description: ID of `Application` to use. | |
in: path | |
name: application_id | |
schema: | |
type: string | |
required: true | |
ApplicationProfileId: | |
description: ID of `Application` profile to use. | |
required: true | |
in: path | |
name: application_profile_id | |
schema: | |
type: string | |
AuthorizationId: | |
description: ID of `Authorization` to fetch. | |
required: true | |
in: path | |
name: authorization_id | |
schema: | |
type: string | |
FeeId: | |
description: ID of `fee` to use. | |
required: true | |
in: path | |
name: fee_id | |
schema: | |
type: string | |
QueryAmountFilter: | |
description: Filter by an amount equal to the given value. | |
in: query | |
name: amount | |
schema: | |
type: integer | |
style: form | |
QueryAmountGtFilter: | |
description: Filter by an amount greater than. | |
in: query | |
name: amount.gt | |
schema: | |
type: integer | |
style: form | |
QueryAmountGteFilter: | |
description: Filter by an amount greater than or equal. | |
in: query | |
name: amount.gte | |
schema: | |
type: integer | |
style: form | |
QueryAmountLtFilter: | |
description: Filter by an amount less than. | |
in: query | |
name: amount.lt | |
schema: | |
type: integer | |
style: form | |
QueryAmountLteFilter: | |
description: Filter by an amount less than or equal. | |
in: query | |
name: amount.lte | |
schema: | |
type: integer | |
style: form | |
QueryApplicationFilter: | |
description: Filter by `Application` ID. | |
in: query | |
name: application | |
schema: | |
type: string | |
style: form | |
QueryCreatedAtGteFilter: | |
description: Filter where `created_at` is after the given date. | |
in: query | |
name: created_at.gte | |
schema: | |
type: string | |
example: '2022-09-27T11:21:23' | |
style: form | |
QueryCreatedAtLteFilter: | |
description: Filter where `created_at` is before the given date. | |
in: query | |
name: created_at.lte | |
schema: | |
type: string | |
example: '2022-09-27T11:21:23' | |
style: form | |
QueryDefaultStatementDescriptorFilter: | |
description: Filter by the `default_statement_descriptor`. | |
in: query | |
name: default_statement_descriptor | |
schema: | |
type: string | |
style: form | |
QueryIdFilter: | |
description: Filter by `id`. | |
in: query | |
name: id | |
schema: | |
type: string | |
style: form | |
QueryIdempotencyIdFilter: | |
description: Filter by `idempotency_id`. | |
in: query | |
name: idempotency_id | |
schema: | |
type: string | |
style: form | |
QueryLimit: | |
description: The numbers of items to return. | |
example: 10 | |
in: query | |
name: limit | |
schema: | |
type: integer | |
style: form | |
QueryOffset: | |
description: The number of items to skip before starting to collect the result set. | |
example: 20 | |
in: query | |
name: offset | |
schema: | |
type: integer | |
style: form | |
QuerySettlementReadyToSettleAtGteFilter: | |
description: 'Filter where `ready_to_settle_at` is after the given date. Only available on `Finix-Version: 2022-02-01`. For more details, see [Versioning](/guides/developers/versioning/).' | |
in: query | |
name: ready_to_settle_at.gte | |
schema: | |
type: string | |
example: '?ready_to_settle_at.gte=2023-06-28T00:00:00' | |
style: form | |
QuerySettlementReadyToSettleAtLteFilter: | |
description: 'Filter where `ready_to_settle_at` is before the given date. Only available on `Finix-Version: 2022-02-01`. For more details, see [Versioning](/guides/developers/versioning/).' | |
in: query | |
name: ready_to_settle_at.lte | |
schema: | |
type: string | |
example: '?ready_to_settle_at.lte=2023-06-28T00:00:00' | |
style: form | |
QuerySort: | |
description: Specify key to be used for sorting the collection. | |
in: query | |
name: sort | |
schema: | |
type: string | |
style: form | |
QueryStatementDescriptorFilter: | |
description: Filter by `statement_descriptor`. | |
in: query | |
name: statement_descriptor | |
schema: | |
type: integer | |
style: form | |
QueryTraceIdFilter: | |
description: Filter by `trace_id`. | |
in: query | |
name: trace_id | |
schema: | |
type: string | |
style: form | |
QueryUpdatedAtGteFilter: | |
description: Filter where `updated_at` is after the given date. | |
in: query | |
name: updated_at.gte | |
schema: | |
type: string | |
style: form | |
QueryUpdatedAtLteFilter: | |
description: Filter where `updated_at` is before the given date. | |
in: query | |
name: updated_at.lte | |
schema: | |
type: string | |
style: form | |
QueryVoidFilter: | |
description: Filter by `idempotency_id`. | |
in: query | |
name: is_void | |
schema: | |
type: string | |
style: form | |
QueryBusinessName: | |
name: business_name | |
in: query | |
required: false | |
schema: | |
type: string | |
description: Filter by the full business name. Partial business names are not supported. | |
QueryBusinessType: | |
name: business_type | |
in: query | |
required: false | |
schema: | |
type: string | |
description: Filter by the business type. Partial business types are not supported. | |
QueryEmail: | |
name: email | |
in: query | |
required: false | |
schema: | |
type: string | |
example: user@example.org | |
description: Filter by the email address or email domain. Partial emails are not supported. | |
QueryFirstName: | |
name: first_name | |
in: query | |
required: false | |
schema: | |
type: string | |
example: Daphne | |
description: Filter by the first name of the person associated to the `Identity`. | |
QueryLastName: | |
name: last_name | |
in: query | |
required: false | |
schema: | |
type: string | |
example: kline | |
description: Filter by the last name of the person associated to the `Identity`. | |
QueryTitle: | |
name: title | |
in: query | |
required: false | |
schema: | |
type: string | |
example: ceo | |
description: Filter by the title if available. | |
QueryAccountLastFour: | |
name: account_last4 | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '9444' | |
description: Filter by the last 4 digits of the account if available. | |
QueryAccountRoutingNumber: | |
name: account_routing_number | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '9444' | |
description: Filter by the account routing number if available. | |
QueryBin: | |
name: bin | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '489514' | |
description: Filter by Bank Identification Number (BIN). The BIN is the first 6 digits of the masked number. | |
QueryExpirationMonth: | |
name: expiration_month | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '1' | |
description: Filter by the expiration month associated with the `Payment Instrument` if applicable. This filter only applies to payment cards. | |
QueryExpirationYear: | |
name: expiration_year | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '2022' | |
description: Filter by the 4 digit expiration year associated with the Payment Instrument if applicable. This filter only applies to payment cards. | |
QueryLastFour: | |
name: last4 | |
in: query | |
required: false | |
schema: | |
type: string | |
example: '0454' | |
description: Filter by the last 4 digits of the `Payment Instrument` card. This filter only applies to payment cards. | |
QueryName: | |
name: name | |
in: query | |
required: false | |
schema: | |
type: string | |
example: john%20smith | |
description: Filter by the name. | |
QueryOwnerIdentity: | |
name: owner_identity_id | |
in: query | |
required: false | |
schema: | |
type: string | |
example: IDcWwprrKrD6cSh225JWPri3 | |
description: Filter by the owner id of the associated `Identity`. | |
QueryPaymentInstrumentType: | |
name: type | |
in: query | |
required: false | |
schema: | |
type: string | |
enum: | |
- ALL | |
- BANK_ACCOUNT | |
- PAYMENT_CARD | |
example: BANK_ACCOUNT | |
description: Filter by the `Payment Instrument` type. | |
QueryAfterCursor: | |
name: after_cursor | |
in: query | |
required: false | |
schema: | |
type: string | |
description: Return every resource created after the cursor value. | |
QueryBeforeCursor: | |
name: before_cursor | |
in: query | |
required: false | |
schema: | |
type: string | |
description: Return every resource created before the cursor value. | |
QueryFormat: | |
name: format | |
in: query | |
required: false | |
schema: | |
type: string | |
example: /download?format=json | |
description: Specify the format you'd like to download the response in (JSON is the only other format available for download). | |
TagsKey: | |
name: tags.key | |
in: query | |
required: false | |
schema: | |
type: string | |
description: 'Filter by the [`key` of a `Tag`](/api/overview/#section/Tags).' | |
TagsValue: | |
name: tags.value | |
in: query | |
required: false | |
schema: | |
type: string | |
description: 'Filter by the [value of a `Tag`](https://finix.com/docs/api/overview/#section/Tags).' | |
QueryStatus: | |
name: status | |
in: query | |
required: false | |
schema: | |
type: string | |
enum: | |
- APPROVED | |
- AWAITING_APPROVAL | |
description: 'Filter by the status of the `Settlement`. Available values include:<ul><li>**APPROVED**<li>**AWAITING_APPROVAL**.</ul> Merchants only receive payouts when `Settlements` are **APPROVED**. For more information, see [Payouts](/docs/guides/payouts/payouts/).' | |
requestBodies: | |
CreateApplicationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateApplicationRequest' | |
examples: | |
Create an Application: | |
value: | |
entity: | |
business_address: | |
city: San Mateo | |
country: USA | |
line1: 741 Douglass St | |
line2: Apartment 8 | |
postal_code: '94114' | |
region: CA | |
business_name: Finix Flowers | |
business_phone: +1 (408) 756-4497 | |
business_tax_id: '123456789' | |
business_type: LIMITED_LIABILITY_COMPANY | |
dob: | |
day: 27 | |
month: 5 | |
year: 1978 | |
doing_business_as: Finix Flowers | |
email: user@example.org | |
first_name: John | |
last_name: Smith | |
max_transaction_amount: 1200000 | |
personal_address: | |
city: San Mateo | |
country: USA | |
line1: 741 Douglass St | |
line2: Apartment 7 | |
postal_code: '94114' | |
region: CA | |
phone: '14158885080' | |
tax_id: '123456789' | |
tags: | |
application_name: Finix Flowers | |
user: USpbnPYf1MMaYYtBqNsNzD6T | |
UpdateApplicationProfileRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateApplicationProfileRequest' | |
CreateAuthorizationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateAuthorizationRequest' | |
examples: | |
Authorization: | |
value: | |
amount: 100 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Authorization - 3D Secure: | |
value: | |
3d_secure_authentication: | |
cardholder_authentication: BwABBJQ1AgAAAAAgJDUCAAAAAAA= | |
electronic_commerce_indicator: AUTHENTICATED | |
transaction_id: EaOMucALHQqLAEGAgk | |
amount: 100 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Authorization - Authorization with CVV: | |
value: | |
amount: 100 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
security_code: '022' | |
source: PI6QyMT6W6c62u5bY8Y17TBj | |
Authorization - Buyer Charges: | |
value: | |
additional_buyer_charges: | |
convenience_amount: 150 | |
amount: 5200 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Authorization - HSA or FSA Card: | |
value: | |
amount: 950 | |
currency: USD | |
hsa_fsa_payment: true | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Authorization - Level 2 Processing: | |
value: | |
additional_purchase_data: | |
customer_reference_number: 321xyz | |
sales_tax: 200 | |
amount: 1000 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Authorization - Level 3 Processing: | |
value: | |
additional_purchase_data: | |
customer_reference_number: 321xyz | |
customs_duty_amount: 10 | |
discount_amount: 100 | |
item_data: | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 175-62-20 | |
cost_per_unit: 500 | |
item_description: printing paper | |
item_discount_amount: 100 | |
merchant_product_code: '1149611' | |
quantity: 1 | |
unit_of_measure: BX | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 207-72-54 | |
cost_per_unit: 500 | |
item_description: printing ink | |
item_discount_amount: 0 | |
merchant_product_code: '2149612' | |
quantity: 1 | |
unit_of_measure: CTN | |
shipping_amount: 100 | |
amount: 1000 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Authorization - Partial Authorization: | |
value: | |
amount: 100 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
partial_authorization: true | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Card Present Authorization - EMV Card: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
operation_key: CARD_PRESENT_AUTHORIZATION | |
tags: | |
order_number: test123transfer | |
Card Present Authorization - Non-EMV Card: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
operation_key: CARD_PRESENT_DEBIT | |
tags: | |
order_number: chris123transfer | |
UpdateAuthorizationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateAuthorizationRequest' | |
examples: | |
Capture Authorization: | |
value: | |
capture_amount: 100 | |
fee: 0 | |
Capture Authorization - Level 2/3 Processing: | |
value: | |
additional_purchase_data: | |
item_data: | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 175-62-20 | |
cost_per_unit: 500 | |
item_description: printing paper | |
item_discount_amount: 100 | |
merchant_product_code: '1149611' | |
quantity: 1 | |
unit_of_measure: BX | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 207-72-54 | |
cost_per_unit: 500 | |
item_description: printing ink | |
item_discount_amount: 0 | |
merchant_product_code: '2149612' | |
quantity: 1 | |
unit_of_measure: CTN | |
customer_reference_number: 321xyz | |
customs_duty_amount: 10 | |
discount_amount: 100 | |
shipping_amount: 100 | |
capture_amount: 100 | |
fee: 0 | |
Void Authorization: | |
value: | |
void_me: true | |
Capture Card Present Authorization: | |
value: | |
capture_amount: 150 | |
CreateDisputeEvidenceRequest: | |
content: | |
multipart/form-data: | |
schema: | |
$ref: '#/components/schemas/CreateDisputeEvidenceRequest' | |
examples: | |
Upload Dispute Evidence: | |
value: | |
file: '@path/to/local/file' | |
CreateFeeRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateFeeRequest' | |
examples: | |
One-Time Fee: | |
value: | |
amount: 1000 | |
currency: USD | |
fee_subtype: CUSTOM | |
fee_type: CUSTOM | |
label: April_Performance_Analytics_Fees | |
merchant_id: MUhQVWbSdd3Da68RKpfodqEV | |
settlement_delay_days: 3 | |
CreateFeeProfileRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateFeeProfileRequest' | |
examples: | |
Create a Fee Profile: | |
value: | |
ach_basis_points: 300 | |
ach_fixed_fee: 30 | |
application: APmuwPBaW8pVcwb4vCTHQH32 | |
basis_points: 200 | |
card_cross_border_basis_points: 300 | |
card_cross_border_fixed_fee: 400 | |
charge_interchange: false | |
fixed_fee: 100 | |
tags: | |
app pricing: sample | |
UpdateFeeRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateFeeRequest' | |
examples: {} | |
CreateIdentityRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateIdentityRequest' | |
examples: | |
Identity - Merchant: | |
value: | |
additional_underwriting_data: | |
annual_ach_volume: 200000 | |
average_ach_transfer_amount: 200000 | |
average_card_transfer_amount: 200000 | |
business_description: SB3 vegan cafe | |
card_volume_distribution: | |
card_present_percentage: 30 | |
mail_order_telephone_order_percentage: 10 | |
ecommerce_percentage: 60 | |
credit_check_allowed: true | |
credit_check_ip_address: 42.1.1.113 | |
credit_check_timestamp: '2021-04-28T16:42:55Z' | |
credit_check_user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
merchant_agreement_accepted: true | |
merchant_agreement_ip_address: 42.1.1.113 | |
merchant_agreement_timestamp: '2021-04-28T16:42:55Z' | |
merchant_agreement_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) | |
refund_policy: MERCHANDISE_EXCHANGE_ONLY | |
volume_distribution_by_business_type: | |
other_volume_percentage: 0 | |
consumer_to_consumer_volume_percentage: 0 | |
business_to_consumer_volume_percentage: 0 | |
business_to_business_volume_percentage: 100 | |
person_to_person_volume_percentage: 0 | |
entity: | |
annual_card_volume: 12000000 | |
business_address: | |
city: San Mateo | |
country: USA | |
region: CA | |
line2: Apartment 8 | |
line1: 741 Douglass St | |
postal_code: '94114' | |
business_name: Finix Flowers | |
business_phone: +1 (408) 756-4497 | |
business_tax_id: '123456789' | |
business_type: INDIVIDUAL_SOLE_PROPRIETORSHIP | |
default_statement_descriptor: Finix Flowers | |
dob: | |
year: 1978 | |
day: 27 | |
month: 6 | |
doing_business_as: Finix Flowers | |
email: user@example.org | |
first_name: John | |
has_accepted_credit_cards_previously: true | |
incorporation_date: | |
year: 1978 | |
day: 27 | |
month: 6 | |
last_name: Smith | |
max_transaction_amount: 1200000 | |
ach_max_transaction_amount: 1000000 | |
mcc: '4900' | |
ownership_type: PRIVATE | |
personal_address: | |
city: San Mateo | |
country: USA | |
region: CA | |
line2: Apartment 7 | |
line1: 741 Douglass St | |
postal_code: '94114' | |
phone: '14158885080' | |
principal_percentage_ownership: 50 | |
tax_id: '123456789' | |
title: CEO | |
url: 'https://www.finix.com' | |
tags: | |
Studio Rating: '4.7' | |
Identity - Buyer: | |
value: | |
entity: | |
phone: '7145677613' | |
first_name: John | |
last_name: Smith | |
email: finix_example@finix.com | |
personal_address: | |
city: San Mateo | |
country: USA | |
region: CA | |
line2: Apartment 7 | |
line1: 741 Douglass St | |
postal_code: '94114' | |
tags: | |
key: value | |
description: '' | |
CreateIdentitySettlementRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSettlementRequest' | |
examples: | |
Create a Settlement: | |
value: | |
currency: USD | |
processor: DUMMY_V1 | |
tags: | |
Internal Daily Settlement ID: 21DFASJSAKAS | |
UpdateMerchantProfileRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateMerchantProfileRequest' | |
examples: | |
Update the Fee Profile for a Merchant Profile: | |
value: | |
fee_profile: FP4xXhxyFRiRePKBQXmueVTh | |
CreateMerchantUnderwritingRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateMerchantUnderwritingRequest' | |
examples: | |
Merchant: | |
value: | |
processor: DUMMY_V1 | |
tags: | |
key_2: value_2 | |
Merchant - Card Present Enabled: | |
value: | |
gateway: TRIPOS_CLOUD_V1 | |
processor: VANTIV_V1 | |
tags: | |
key_2: value_2 | |
CreatePaymentInstrumentRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreatePaymentInstrumentRequest' | |
descriminator: | |
propertyName: type | |
examples: | |
Payment Instrument - Card: | |
value: | |
address: | |
city: San Francisco | |
country: USA | |
line1: 900 Metro Center Blv | |
postal_code: '94404' | |
region: CA | |
expiration_month: 12 | |
expiration_year: 2029 | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
name: John Smith | |
number: '5200828282828210' | |
security_code: '022' | |
type: PAYMENT_CARD | |
Payment Instrument - Bank Account: | |
value: | |
account_number: '123123123' | |
account_type: SAVINGS | |
bank_code: '123123123' | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
name: John Smith | |
type: BANK_ACCOUNT | |
Payment Instrument - Token: | |
value: | |
token: TKiMxe323RE5Dq3wLVtG8kSW | |
type: TOKEN | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
Payment Instrument - Apple Pay: | |
value: | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
merchant_identity: IDpYDM7J9n57q849o9E9yNrG | |
name: John Smith | |
third_party_token: '{"token":{"paymentMethod":{"network":"barcode","type":"credit","displayName":""},"transactionIdentifier":"AE514ADAA44E9C3A0A862C7E4EDEE43C422556FA4748B045F1764860557E8EE6","paymentData":{"data":"IOg9H5\/hdpccvHZ03ESJwlJXFlmcnI18WXTSOHOPA82ewYoWVyEMiy63HCsdejXsHIR8a+N\/5aR24OeJrkxheck2AAl5o1LLJ7jL+75scnf7Z55uQmtVyKITTkH22LrC6E6SgMnXaefJYOTUcG1Veqb\/dXtpPzqaKACEKDkbVivpDk+A2iX5PLROFTMRgmb9a0HYwHOnVGQzXwiHkX1g6f1R4rILUyMaQ5qLxCplE1t\/guEYmkGBtOb\/v8+GRDTl8YrC1tOe\/cs4aQm4cAKJktFQUTbfAApNFBnKI06mtCM7e7qRna\/YON3gyci035jA7Zq4kBMo7rQB8puGH6dDqB\/KsPS6Ps+w688+rqEKz16YUJ\/LMCOzzBM6bCTOS6eouB1eCh3SJdm\/lmY=","signature":"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIID4zCCA4igAwIBAgIITDBBSVGdVDYwCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE5MDUxODAxMzI1N1oXDTI0MDUxNjAxMzI1N1owXzElMCMGA1UEAwwcZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtUFJPRDEUMBIGA1UECwwLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhV37evWx7Ihj2jdcJChIY3HsL1vLCg9hGCV2Ur0pUEbg0IO2BHzQH6DMx8cVMP36zIg1rrV1O\/0komJPnwPE6OCAhEwggINMAwGA1UdEwEB\/wQCMAAwHwYDVR0jBBgwFoAUI\/JJxE+T5O8n5sT2KGw\/orv9LkswRQYIKwYBBQUHAQEEOTA3MDUGCCsGAQUFBzABhilodHRwOi8vb2NzcC5hcHBsZS5jb20vb2NzcDA0LWFwcGxlYWljYTMwMjCCAR0GA1UdIASCARQwggEQMIIBDAYJKoZIhvdjZAUBMIH+MIHDBggrBgEFBQcCAjCBtgyBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmFwcGxlLmNvbS9jZXJ0aWZpY2F0ZWF1dGhvcml0eS8wNAYDVR0fBC0wKzApoCegJYYjaHR0cDovL2NybC5hcHBsZS5jb20vYXBwbGVhaWNhMy5jcmwwHQYDVR0OBBYEFJRX22\/VdIGGiYl2L35XhQfnm1gkMA4GA1UdDwEB\/wQEAwIHgDAPBgkqhkiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0kAMEYCIQC+CVcf5x4ec1tV5a+stMcv60RfMBhSIsclEAK2Hr1vVQIhANGLNQpd1t1usXRgNbEess6Hz6Pmr2y9g4CJDcgs3apjMIIC7jCCAnWgAwIBAgIISW0vvzqY2pcwCgYIKoZIzj0EAwIwZzEbMBkGA1UEAwwSQXBwbGUgUm9vdCBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwHhcNMTQwNTA2MjM0NjMwWhcNMjkwNTA2MjM0NjMwWjB6MS4wLAYDVQQDDCVBcHBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAATwFxGEGddkhdUaXiWBB3bogKLv3nuuTeCN\/EuT4TNW1WZbNa4i0Jd2DSJOe7oI\/XYXzojLdrtmcL7I6CmE\/1RFo4H3MIH0MEYGCCsGAQUFBwEBBDowODA2BggrBgEFBQcwAYYqaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZXJvb3RjYWczMB0GA1UdDgQWBBQj8knET5Pk7yfmxPYobD+iu\/0uSzAPBgNVHRMBAf8EBTADAQH\/MB8GA1UdIwQYMBaAFLuw3qFYM4iapIqZ3r6966\/ayySrMDcGA1UdHwQwMC4wLKAqoCiGJmh0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlcm9vdGNhZzMuY3JsMA4GA1UdDwEB\/wQEAwIBBjAQBgoqhkiG92NkBgIOBAIFADAKBggqhkjOPQQDAgNnADBkAjA6z3KDURaZsYb7NcNWymK\/9Bft2Q91TaKOvvGcgV5Ct4n4mPebWZ+Y1UENj53pwv4CMDIt1UQhsKMFd2xd8zg7kGf9F3wsIW2WT8ZyaYISb1T4en0bmcubCYkhYQaZDwmSHQAAMYIBjDCCAYgCAQEwgYYwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTAghMMEFJUZ1UNjANBglghkgBZQMEAgEFAKCBlTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yMjA0MDExODE2MjJaMCoGCSqGSIb3DQEJNDEdMBswDQYJYIZIAWUDBAIBBQChCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEINpyGxYyGbl1Kj57wU\/3PijxngHUcidFy9jukG9sccOHMAoGCCqGSM49BAMCBEcwRQIhAPHvbeAIDmJKf2YGS5xcCoySSeCeFf6ThUsKE3UIPWBJAiBQIZZu4wTlZn7R16N+2iTfvuvzJKgeSv8rAs3YM6z56AAAAAAAAA==","header":{"publicKeyHash":"eOvce9ya55opFC5EXVWlLwzZRVDEY3Hgakf3+C+0zkc=","ephemeralPublicKey":"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE3VnkF5JR9cWuYoeT68dUNp\/2\/jGaOiid19UfCV9rEkcPomrzFWEZw\/dN1uU9RTblnrIQPajFj4R2ZKIpYIlkgA==","transactionId":"ae514adaa44e9c3a0a862c7e4edee43c422556fa4748b045f1764860557e8ee6"},"version":"EC_v1"}}}' | |
type: APPLE_PAY | |
Payment Instrument - Google Pay: | |
value: | |
identity: ID78Fh8mcnnzukVzbdoyex5y | |
merchant_identity: IDwhCCvPwCDEmiFd8Be7pDzN | |
name: Finix Sandbox | |
third_party_token: '{"signature":"MEYCIQCYTkaEMgug7pcjzEEdbIn+R57kYO5yYc2KYj41AQQn9wIhAN1QvylvZ2XydVecfejwi2xYS9y3Y9y/MmDnRnUfNw5H","intermediateSigningKey":{"signedKey":"{\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE4xc3fjeM9SMTjd1TL2GQCPmgqPf2h42aM3akPh/mTUBqWEgOITruK10A02rQ+4YZOvLCpQKQZzLSAd09nctnuA\\u003d\\u003d\",\"keyExpiration\":\"1648843199734\"}","signatures":["MEQCICwCI4s5YCLu4qRCyXwSJ3qG8y3ocFtP1Mque4Uzysl8AiARoD/0qbj5W0Q2PWKpxkEnfcP+nU5kwYS8FyQ9boDTmQ\u003d\u003d"]},"protocolVersion":"ECv2","signedMessage":"{\"encryptedMessage\":\"roD4ikTpZ7Srunq+0zUnp+eiXzcuZBfIFSuZAJu1PQLXcP0RvnGDiGKtoarNCHvn+cnXsHCzIBWXMZSJ9Aglqky9VfP5a+qsXQhf5m5AFUbT2xnihtKwageGQQK6HzyjHSXXSjvuCzeo75ToOgIUxLFASZyaZ89u3Jifqhhc2c4a0Mtlx564BxXiwcxDFdtNkOle7uAIsJzsryk7Rcwgr8ZMJJM//XpvaeE5wNmkVFHUtR2uTqPm0BvkoYkFHCTRo4NHXWpxeLjXWzKGk2ELyTK1diuCa6c9ig0jO3t8BIh1cR63UeP8Ar7u5fh8C9FPPAsgPbTGLfiaRe615e4SxASgcZ4/8uWo5mikEPFqA5s2K2mid9ncXoMNYaHUc3qzJAyxHVYSd5SRNZYXHMkEcWcjnpDx+ErYjR1sMo1LMYXfrfGyZz3M69bQLKPYFe7ChjvgFI9MnfcFTNB4HAdNKMhbZT0EKinfxxGWkT7LVbGnUuqPlHp4toCe4kpbx7fulwXTj3bAFvg/qvxxwGOS38iP0HR/f+4GF0xHspqYVbdWdIJ5iJUdpBG8Nu5P56h2GEDxXMkKSmh+qbvKWlYipNNGoeg8uHc\\u003d\",\"ephemeralPublicKey\":\"BMqIyb1IyXhuZ4YpWm1PiRr74i3tCwDfQqJ1P4OZ3zK4Rq16SuwgJ605fCEvlViwSQuo2Hpv+CcR+2D3+/YrLB8\\u003d\",\"tag\":\"5K4LlTucDK7jAThbIozYtyoxX95hRNd5cJJGfxWAxw8\\u003d\"}"}' | |
type: GOOGLE_PAY | |
description: '' | |
CreateProcessorRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateProcessorRequest' | |
examples: | |
'Enable an Application Processor ': | |
value: | |
config: | |
canDebitBankAccount: true | |
type: DUMMY_V1 | |
UpdateProcessorRequest: | |
content: | |
application/json: | |
schema: | |
type: object | |
CreateReversalRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateReversalRequest' | |
examples: | |
Refund Transfer: | |
value: | |
refund_amount: 100 | |
tags: | |
test: refund | |
Refund Transfer - Card Present: | |
value: | |
device: DVkBqa68V1ZQusodU8o6mB62 | |
refund_amount: 150 | |
Refund Transfer - Swiped Card: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
operation_key: CARD_PRESENT_UNREFERENCED_REFUND | |
tags: | |
test: refund | |
Refund Transfer - Split Transaction: | |
value: | |
refund_amount: 1000 | |
split_transfers: | |
- merchant: MU4jpoNGRkAyjBxumZhGa6Hc | |
amount: 600 | |
tags: | |
key: value | |
- merchant: MUeHUEPKybMjqV1STcqrFTSH | |
amount: 300 | |
- merchant: MU3Gh6DT5fCBxVtWB8VJc1St | |
amount: 100 | |
tags: | |
test: refund | |
CreateSettlementRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSettlementRequest' | |
CreateTransferRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateTransferRequest' | |
examples: | |
Transfer: | |
value: | |
amount: 662154 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - 3D Secure: | |
value: | |
3d_secure_authentication: | |
cardholder_authentication: BwABBJQ1AgAAAAAgJDUCAAAAAAA= | |
electronic_commerce_indicator: AUTHENTICATED | |
transaction_id: EaOMucALHQqLAEGAgk | |
amount: 92169 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - Card Verification Checks: | |
value: | |
amount: 662154 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
security_code: '022' | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
Transfer - Buyer Charges: | |
value: | |
additional_buyer_charges: | |
convenience_amount: 150 | |
amount: 5200 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - Debit Bank Account: | |
value: | |
amount: 6031 | |
currency: USD | |
fee: 603 | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIr1Ru7ewBkEYVVn7SP1u5FW | |
tags: | |
order_number: 21DFASJSAKAS | |
Transfer - HSA or FSA Cards: | |
value: | |
amount: 950 | |
currency: USD | |
hsa_fsa_payment: true | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
order_number: 21DFASJSAKAS | |
Transfer - Level 2 Processing: | |
value: | |
additional_purchase_data: | |
customer_reference_number: 321xyz | |
sales_tax: 200 | |
amount: 1000 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - Level 3 Processing: | |
value: | |
additional_purchase_data: | |
item_data: | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 175-62-20 | |
cost_per_unit: 500 | |
item_description: printing paper | |
item_discount_amount: 100 | |
merchant_product_code: '1149611' | |
quantity: 1 | |
unit_of_measure: BX | |
- amount_excluding_sales_tax: 400 | |
amount_including_sales_tax: 500 | |
commodity_code: 207-72-54 | |
cost_per_unit: 500 | |
item_description: printing ink | |
item_discount_amount: 0 | |
merchant_product_code: '2149612' | |
quantity: 1 | |
unit_of_measure: CTN | |
customer_reference_number: 321xyz | |
customs_duty_amount: 10 | |
discount_amount: 100 | |
shipping_amount: 100 | |
amount: 1000 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - Partial Authorization: | |
value: | |
amount: 662154 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
partial_authorization: true | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
tags: | |
test: sale | |
Transfer - Split Transaction: | |
value: | |
amount: 1000 | |
currency: USD | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: | |
- merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
amount: 600 | |
tags: | |
key: value | |
- merchant: MUeHUEPKybMjqV1STcqrFTSH | |
amount: 300 | |
- merchant: MU3Gh6DT5fCBxVtWB8VJc1St | |
amount: 100 | |
tags: | |
test: sale | |
Card Present Transfer - EMV Card: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
operation_key: CARD_PRESENT_DEBIT | |
tags: | |
order_number: chris123transfer | |
Card Present Transfer - Manual Entry: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
device_configuration: | |
prompt_manual_entry: true | |
operation_key: CARD_PRESENT_DEBIT | |
tags: | |
order_number: chris123transfer | |
Card Present Transfer - Non-EMV Card: | |
value: | |
amount: 150 | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
operation_key: CARD_PRESENT_DEBIT | |
tags: | |
order_number: chris123transfer | |
UpdateDeviceRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateDeviceRequest' | |
examples: | |
Device - Activated (DATACAP_V1): | |
value: | |
action: ACTIVATE | |
Device - Activated (TRIPOS_CLOUD_V1): | |
value: | |
action: ACTIVATE | |
activation_code: '609732' | |
Reboot Device: | |
value: | |
action: REBOOT | |
Device - Idle Message Set: | |
value: | |
action: CREATE_IDLE_MESSAGE | |
idle_message: Finix Flowers | |
Device - Deactivated: | |
value: | |
action: DEACTIVATE | |
Device - Update Details: | |
value: | |
configuration: | |
allow_debit: true | |
bypass_device_on_capture: true | |
prompt_signature: NEVER | |
description: Flowers | |
name: Finix Flowers - triPOS | |
CreateUserRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateUserRequest' | |
CreateVerificationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateVerificationRequest' | |
examples: | |
Payment Instrument - Verify a Card’s CVV: | |
value: | |
merchant: MUgWbPVvtKbzjKNNGKqdQYV7 | |
security_code: '123' | |
verify_payment_card: true | |
Payment Instrument - Verify a Card’s Address: | |
value: | |
address: | |
city: San Francisco | |
country: USA | |
line1: 900 Metro Center Blv | |
postal_code: '94404' | |
region: CA | |
merchant: MUgWbPVvtKbzjKNNGKqdQYV7 | |
verify_payment_card: true | |
Payment Instrument - Verify Push-to-Card Eligibility: | |
value: | |
processor: VISA_V1 | |
tags: | |
card_name: Business_Card | |
CreateWebhookRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateWebhookRequest' | |
examples: | |
Webhook: | |
value: | |
authentication: | |
type: NONE | |
url: 'https://example.com/event_handler' | |
Webhook - Basic Authentication: | |
value: | |
authentication: | |
type: BASIC | |
basic: | |
username: basic-auth-username | |
password: basic-auth-password | |
url: 'https://example.com/event_handler' | |
Webhook - Bearer Token Authentication: | |
value: | |
authentication: | |
type: BEARER | |
bearer: | |
token: U3VwZXIgc2VjcmV0IGVuY29kZWQgdG9rZW4= | |
enabled: true | |
url: 'https://example.com/event_handler' | |
UpdateTransferRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateTransferRequest' | |
examples: | |
example-1: | |
value: | |
tags: | |
test: sale | |
UpdateSettlementRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateSettlementRequest' | |
CreateSubscriptionAmountRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSubscriptionAmountRequest' | |
examples: | |
Create a POS_INSTALLMENT_FEE amount: | |
value: | |
amount_type: FEE | |
fee_amount_data: | |
amount: 2500 | |
currency: USD | |
label: POS_INSTALLMENT_FEE | |
nickname: POS_INSTALLMENT_FEE | |
tags: | |
order_number: '124' | |
UpdateSubscriptionAmountRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSubscriptionAmountRequest' | |
examples: | |
Update a Subscription Amount: | |
value: | |
amount_type: FEE | |
fee_amount_data: | |
amount: 2500 | |
currency: USD | |
label: POS_INSTALLMENT_FEE | |
nickname: POS_INSTALLMENT_FEE | |
tags: | |
order_number: '124' | |
CreateSubscriptionScheduleRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSubscriptionScheduleRequest' | |
examples: | |
Subscription Schedule - FIXED_TIME_INTERVAL: | |
value: | |
line_item_type: FEE | |
nickname: Fixed_Time_Subscription_Schedule | |
fixed_time_interval_offset: | |
interval_count: 4 | |
hourly_interval: 24 | |
subscription_type: FIXED_TIME_INTERVAL | |
Subscription Schedule - PERIODIC_MONTHLY: | |
value: | |
line_item_type: FEE | |
period_offset: | |
day: 1 | |
month: null | |
nickname: Monthly_Subscription_Schedule | |
subscription_type: PERIODIC_MONTHLY | |
Subscription Schedule - PERIODIC_YEARLY: | |
value: | |
line_item_type: FEE | |
period_offset: | |
day: 5 | |
month: 1 | |
nickname: Yearly_Subscription_Schedule | |
subscription_type: PERIODIC_YEARLY | |
UpdateSubscriptionScheduleRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateSubscriptionScheduleRequest' | |
examples: | |
Update Tags: | |
value: | |
tags: | |
order-reference: A1B2C3D4E5 | |
CreateSubscriptionEnrollmentRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateSubscriptionEnrollmentRequest' | |
examples: | |
Example of a "Security Fee": | |
value: | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
nickname: Security Fee | |
started_at: '2022-11-11T16:50:59.891Z' | |
tags: | |
enrollment_info: Security Fee Enrollment | |
UpdateSubscriptionEnrollmentRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateSubscriptionEnrollmentRequest' | |
UpdateUserRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateUserRequest' | |
examples: | |
Update User: | |
value: | |
tags: | |
card_name: New Employee | |
CreateDeviceRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateDevice' | |
examples: | |
Create a Device: | |
value: | |
configuration: | |
allow_debit: true | |
bypass_device_on_capture: true | |
prompt_signature: NEVER | |
description: John Smith | |
model: MX915 | |
name: 'Finix triPOS #1' | |
UpdatePaymentInstrumentRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdatePaymentInstrumentRequest' | |
examples: | |
Payment Instrument - Update a Card's Address: | |
value: | |
address: | |
city: Los Angeles | |
region: CA | |
postal_code: '90036' | |
line1: 270 Lincoln Center Blv | |
line2: Suite 1A | |
country: USA | |
merchant: MUjJUJxMKoL24H8MotYNjtZP | |
verify_payment_card: true | |
Payment Instrument - Disable a Payment Instrument: | |
value: | |
enabled: false | |
tags: | |
card_name: Personal Card | |
Payment Instrument - Bank Account Validation Check: | |
value: | |
attempt_bank_account_validation_check: 'true' | |
Payment Instrument - Update Payment Instrument Tags: | |
value: | |
tags: | |
card_name: Personal Card | |
UpdateMerchantRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateMerchantRequest' | |
examples: | |
Merchant - Disable a Merchant: | |
value: | |
processing_enabled: false | |
Merchant - Enable Buyer Charges: | |
value: | |
convenience_charges_enabled: true | |
rent_surcharges_enabled: true | |
Merchant - Enable Level 2/3 Processing: | |
value: | |
level_two_level_three_data_enabled: true | |
Merchant - Enable Partial Authorizations: | |
value: | |
default_partial_authorization_enabled: true | |
UpdateIdentityRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateIdentityRequest' | |
examples: | |
Update an Identity: | |
value: | |
entity: | |
email: user@example.org | |
first_name: John | |
last_name: Smith | |
phone: '7145677613' | |
CreateAssociatedIdentityRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateAssociatedIdentityRequest' | |
examples: | |
Associated Identity: | |
value: | |
entity: | |
dob: | |
day: 1 | |
month: 1 | |
year: 2013 | |
email: john.smith@company1.com | |
first_name: John | |
last_name: Smith | |
personal_address: | |
city: San Francisco | |
country: USA | |
line1: 123 Main Street | |
postal_code: '90650' | |
region: CA | |
phone: '14158885080' | |
principal_percentage_ownership: 25 | |
tax_id: '123456789' | |
title: Founder | |
CreateBalanceTransferRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateBalanceTransferRequest' | |
examples: | |
Create a Balance Transfer: | |
value: | |
amount: 4000 | |
currency: USD | |
description: Need to increase buffer given the high number of NSFs on merchant fee debits | |
destination: FOR_BENEFIT_OF_ACCOUNT | |
processor_type: LITLE_V1 | |
source: OPERATING_ACCOUNT | |
tags: | |
example: documentation tag | |
CreateInstrumentUpdateRequest: | |
content: | |
multipart/form-data: | |
schema: | |
$ref: '#/components/schemas/CreateInstrumentUpdateRequest' | |
examples: | |
Instrument Update Request: | |
value: | |
request: '{"merchant": "MUucec6fHeaWo3VHYoSkUySM","idempotency_id": "123xyz testing"}' | |
description: '' | |
CreateFileRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateFileRequest' | |
examples: | |
Create a File: | |
value: | |
display_name: My Drivers License | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
tags: | |
key_1: value_1 | |
type: DRIVERS_LICENSE_FRONT | |
CreateExternalLinkRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateExternalLinkRequest' | |
examples: | |
Create an External Link: | |
value: | |
duration: 15 | |
type: UPLOAD | |
CreateApplePaySessionRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ApplePaySessionRequest' | |
examples: | |
Create an Apple Pay Session: | |
value: | |
display_name: Finix Test Merchant | |
domain: www.finixtestmerchant.com | |
merchant_identity: IDmULj61C8ke6Y7qQiKENJ7 | |
validation_url: 'https://apple-pay-gateway-cert.apple.com/paymentservices/paymentSession' | |
RemoveSettlementTransfer: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/RemoveSettlementTransfer' | |
examples: | |
Remove a Transfer in a Settlement: | |
value: | |
transfers: | |
- TRr61njQxaa7AJf6E1C3QwCc | |
UploadFileRequest: | |
content: | |
multipart/form-data: | |
schema: | |
$ref: '#/components/schemas/UploadFileRequest' | |
UpdateWebhookRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateWebhookRequest' | |
examples: | |
Update Webhook: | |
value: | |
enabled: true | |
url: 'https://eohzjuj2prziycz.m.pipedream.net' | |
Filter Webhook Events: | |
value: | |
enabled_events: | |
- entity: merchant | |
types: | |
- created | |
- underwritten | |
- entity: transfer | |
types: | |
- created | |
UpdateComplianceForm: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateComplianceFormRequest' | |
examples: | |
Complete Compliance Form: | |
value: | |
pci_saq_a: | |
ip_address: 42.1.1.113 | |
name: John Smith | |
signed_at: '2022-03-18T16:42:55Z' | |
title: CTO | |
user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
CreateOnboardingFormRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateOnboardingFormRequest' | |
examples: | |
Create an Onboarding Form: | |
value: | |
onboarding_data: | |
entity: | |
title: CEO | |
first_name: John | |
last_name: Smith | |
email: john.smith@finix.com | |
business_name: Finix Flowers | |
business_type: CORPORATION | |
doing_business_as: Finix Flowers | |
phone: '14158885080' | |
business_phone: '14158885080' | |
personal_address: | |
city: Seattle | |
country: USA | |
line1: 123 Boren Ave | |
postal_code: '98040' | |
region: WA | |
business_address: | |
city: Bellevue | |
country: USA | |
line1: 123 Bellevue Way | |
postal_code: '98039' | |
region: WA | |
dob: | |
day: 13 | |
month: 4 | |
year: 1982 | |
incorporation_date: | |
day: 9 | |
month: 3 | |
year: 2018 | |
mcc: '4900' | |
url: 'https://www.finix.com' | |
ownership_type: PRIVATE | |
default_statement_descriptor: DEMOCOMPANY | |
max_transaction_amount: 100000 | |
annual_card_volume: 1000000 | |
principal_percentage_ownership: 75 | |
tax_id: '123456789' | |
business_tax_id: '123456789' | |
has_accepted_credit_cards_previously: false | |
additional_underwriting_data: | |
refund_policy: NO_REFUNDS | |
card_volume_distribution: | |
ecommerce_percentage: 100 | |
card_present_percentage: 0 | |
mail_order_telephone_order_percentage: 0 | |
average_ach_transfer_amount: 200000 | |
average_card_transfer_amount: 20000 | |
annual_ach_volume: 2000000 | |
business_description: CONSUMER | |
volume_distribution_by_business_type: | |
other_volume_percentage: 0 | |
person_to_person_volume_percentage: 0 | |
business_to_business_volume_percentage: 90 | |
business_to_consumer_volume_percentage: 10 | |
consumer_to_consumer_volume_percentage: 0 | |
associated_entities: | |
- title: CFO | |
first_name: Alex | |
last_name: Smith | |
email: alex.smith@finix.com | |
phone: '14158885080' | |
personal_address: | |
city: Bellevue | |
country: USA | |
line1: 4848 84th St | |
postal_code: '98032' | |
region: WA | |
dob: | |
day: 13 | |
month: 4 | |
year: 1985 | |
principal_percentage_ownership: 25 | |
tax_id: '123456789' | |
payment_instruments: | |
name: SARAH BANKER | |
bank_code: '123456789' | |
account_number: '123456789' | |
account_type: CHECKING | |
type: BANK_ACCOUNT | |
max_transaction_amount: 100000 | |
merchant_processors: | |
- processor: LITLE_V1 | |
onboarding_link_details: | |
return_url: 'https://www.finixflowers.com/' | |
expired_session_url: 'https://www.finixflowers.com/login' | |
terms_of_service_url: 'https://www.finixflowers.com/ToS' | |
fee_details_url: 'https://www.finixflowers.com/fee_details' | |
expiration_in_minutes: 10080 | |
CreateOnboardingFormLinkRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CreateOnboardingFormLinkRequest' | |
examples: | |
Create an Onboarding Form Link: | |
value: | |
expiration_in_minutes: 10080 | |
expired_session_url: 'https://www.finix.com/' | |
fee_details_url: 'https://www.finix.com/docs' | |
return_url: 'https://www.finix.com/docs' | |
terms_of_service_url: 'https://www.finix.com/terms-and-policies' | |
UpdatePayoutProfileRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdatePayoutProfileRequest' | |
examples: | |
Payout Profile - Gross: | |
value: | |
type: GROSS | |
gross: | |
payouts: | |
frequency: DAILY | |
submission_delay_days: '1' | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
fees: | |
frequency: MONTHLY | |
day_of_month: '1' | |
submission_delay_days: '3' | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
Payout Profile - Net: | |
value: | |
type: NET | |
net: | |
frequency: CONTINUOUS | |
submission_delay_days: '1' | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
VoidAuthorizationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/VoidAuthorization' | |
examples: | |
Void Authorization: | |
value: | |
void_me: true | |
SubmitDisputeEvidence: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubmitDisputeEvidence' | |
examples: | |
Example 1: | |
value: | |
note: '"Submitting Dispute Evidence: July 23rd Receipt"' | |
UpdateDisputeEvidence: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UpdateDisputeEvidence' | |
examples: | |
Dispute - Tags: | |
value: | |
tags: | |
order_number: 41BFASJSAKAS | |
AcceptDisputeRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/AcceptDispute' | |
examples: | |
Dispute Accepted: | |
value: | |
note: 'Accepting Dispute: Valid Reason' | |
CloseSettlement: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/CloseSettlement' | |
examples: | |
Close Settlement: | |
value: | |
action: STOP_ACCRUAL | |
CreateSplitTransferRequest: | |
content: | |
application/json: | |
schema: | |
type: object | |
CreateMerchantVerificationRequest: | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/MerchantPIVerification' | |
examples: | |
Merchant - Reverify a Merchant: | |
value: {} | |
responses: | |
Application: | |
description: Single application object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Application' | |
examples: | |
Application Created: | |
value: | |
id: APgPDQrLD52TYvqazjHJJchM | |
created_at: '2022-01-27T07:36:33.59Z' | |
updated_at: '2022-01-27T07:44:04.94Z' | |
card_cvv_required: false | |
card_expiration_date_required: true | |
creating_transfer_from_report_enabled: true | |
enabled: true | |
fee_ready_to_settle_upon: RECONCILIATION | |
name: BrainTree | |
owner: IDuquemzE7UkUJioGJfVKBKt | |
processing_enabled: true | |
ready_to_settle_upon: RECONCILIATION | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
tags: | |
application_name: BrainTree | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
processors: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/processors' | |
users: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/users' | |
owner_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuquemzE7UkUJioGJfVKBKt' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/transfers' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/disputes' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/authorizations' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/settlements' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/merchants' | |
identities: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/identities' | |
webhooks: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/webhooks' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/reversals' | |
tokens: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/tokens' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/payment_instruments' | |
application_profile: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM/application_profile' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ApplicationProfile: | |
description: Single application_profile object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ApplicationProfile' | |
examples: | |
Application Profile: | |
value: | |
id: PPqjTEKAmRNGLquQUeLKmXhi | |
created_at: '2022-01-27T07:36:33.65Z' | |
updated_at: '2022-01-27T07:37:38.07Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
fee_profile: FPvCQUcnsueN3Bc3zR1qCBG8 | |
risk_profile: RPvF6X3AcLnvMby9wBkaVoBi | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/application_profiles/PPqjTEKAmRNGLquQUeLKmXhi' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
risk_profile: | |
href: 'https://finix.sandbox-payments-api.com/risk_profiles/RPvF6X3AcLnvMby9wBkaVoBi' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ApplicationProfilesList: | |
description: List of application_profile objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ApplicationProfilesList' | |
examples: | |
List of Application Profiles: | |
value: | |
_embedded: | |
application_profiles: | |
- id: PPqjTEKAmRNGLquQUeLKmXhi | |
created_at: '2022-01-27T07:36:33.65Z' | |
updated_at: '2022-01-27T07:37:38.07Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
fee_profile: FPvCQUcnsueN3Bc3zR1qCBG8 | |
risk_profile: RPvF6X3AcLnvMby9wBkaVoBi | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/application_profiles/PPqjTEKAmRNGLquQUeLKmXhi' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
risk_profile: | |
href: 'https://finix.sandbox-payments-api.com/risk_profiles/RPvF6X3AcLnvMby9wBkaVoBi' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/application_profiles?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ApplicationsList: | |
description: List of `Applications`. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ApplicationsList' | |
examples: | |
List of Applications: | |
value: | |
_embedded: | |
applications: | |
- id: APdoThHn4jjYUSxQf76txAgg | |
created_at: '2022-09-20T23:03:21.74Z' | |
updated_at: '2022-09-20T23:03:21.74Z' | |
card_cvv_required: false | |
card_expiration_date_required: true | |
creating_transfer_from_report_enabled: false | |
enabled: true | |
fee_ready_to_settle_upon: RECONCILIATION | |
name: Abhishek Test | |
owner: IDpxUfpKm1UCqtx5N4SkqVr5 | |
processing_enabled: true | |
ready_to_settle_upon: RECONCILIATION | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg' | |
processors: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/processors' | |
users: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/users' | |
owner_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpxUfpKm1UCqtx5N4SkqVr5' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/transfers' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/disputes' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/authorizations' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/settlements' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/merchants' | |
identities: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/identities' | |
webhooks: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/webhooks' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/reversals' | |
tokens: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/tokens' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/payment_instruments' | |
application_profile: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdoThHn4jjYUSxQf76txAgg/application_profile' | |
- id: APrpAfFbr9TqMw1FXLAD6vNg | |
created_at: '2022-04-29T00:48:15.01Z' | |
updated_at: '2022-04-29T00:48:16.56Z' | |
card_cvv_required: false | |
card_expiration_date_required: true | |
creating_transfer_from_report_enabled: false | |
enabled: true | |
fee_ready_to_settle_upon: RECONCILIATION | |
name: BrainTree | |
owner: IDfEzc4SsQkk1FN516DDQWuj | |
processing_enabled: true | |
ready_to_settle_upon: RECONCILIATION | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
tags: | |
application_name: BrainTree | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg' | |
processors: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/processors' | |
users: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/users' | |
owner_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDfEzc4SsQkk1FN516DDQWuj' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/transfers' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/disputes' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/authorizations' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/settlements' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/merchants' | |
identities: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/identities' | |
webhooks: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/webhooks' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/reversals' | |
tokens: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/tokens' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/payment_instruments' | |
application_profile: | |
href: 'https://finix.sandbox-payments-api.com/applications/APrpAfFbr9TqMw1FXLAD6vNg/application_profile' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/applications?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/applications?offset=110400&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 110412 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Authorization: | |
description: Single Authorization object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Authorization' | |
examples: | |
Authorization: | |
value: | |
id: AUvZbBaTJkFCbiAMrGtc66ko | |
created_at: '2022-10-11T02:27:39.10Z' | |
updated_at: '2022-10-11T02:27:39.48Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-18T02:27:39.10Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: e1a10287-4909-4aa7-9cb7-abd069a3b833 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUvZbBaTJkFCbiAMrGtc66ko' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - 3D Secure: | |
value: | |
id: AUtmuV1dapVdEe16ivUEUhSE | |
created_at: '2022-10-11T02:28:28.50Z' | |
updated_at: '2022-10-11T02:28:28.66Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-18T02:28:28.50Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 20374045-2f90-48f4-80e0-7edf32b9e626 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUtmuV1dapVdEe16ivUEUhSE' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - Authorization with CVV: | |
value: | |
id: AUg5fBP1vDXcFtSdiL3e4vzp | |
created_at: '2022-10-11T02:32:54.64Z' | |
updated_at: '2022-10-11T02:32:55.05Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-18T02:32:54.64Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PI6QyMT6W6c62u5bY8Y17TBj | |
state: SUCCEEDED | |
tags: {} | |
trace_id: 526f28d0-73eb-46d6-b78c-aad6ab891dba | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUg5fBP1vDXcFtSdiL3e4vzp' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - Buyer Charges: | |
value: | |
id: AUt6moAj3sgpszzC3n9cRZKN | |
created_at: '2023-12-06T17:47:03.85Z' | |
updated_at: '2023-12-06T17:47:03.85Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: | |
convenience_amount: 150 | |
surcharge_amount: 0 | |
rent_surcharge_amount: 0 | |
additional_healthcare_data: null | |
additional_purchase_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 5200 | |
amount_requested: 5200 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2023-12-13T17:47:03.85Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
receipt_last_printed_at: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
test: sale | |
trace_id: a81e66e9-73d4-4112-88da-8b4ac7afd381 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUt6moAj3sgpszzC3n9cRZKN' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - HSA or FSA Card: | |
value: | |
id: AUo8BiLgvzZzT41KBB7C8GQo | |
created_at: '2022-10-10T06:32:17.04Z' | |
updated_at: '2022-10-10T06:32:17.30Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 950 | |
amount_requested: 950 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-17T06:32:17.04Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: f702ed93-d38d-430d-8924-a09d946e037c | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUo8BiLgvzZzT41KBB7C8GQo' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - Level 2 Processing: | |
value: | |
id: AUpkH5f8YoLe2DBNKgqCua4N | |
created_at: '2022-10-11T02:28:59.99Z' | |
updated_at: '2022-10-11T02:29:00.47Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-18T02:28:59.99Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 595ef280-35b9-4566-8884-7333739245f9 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUpkH5f8YoLe2DBNKgqCua4N' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - Level 3 Processing: | |
value: | |
id: AUeNCQ37HbQgVQtToJiUtxpd | |
created_at: '2022-10-11T02:29:36.07Z' | |
updated_at: '2022-10-11T02:29:36.24Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-18T02:29:36.07Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 3ce1a866-6a38-4a3b-b993-6ac9529afa53 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUeNCQ37HbQgVQtToJiUtxpd' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Authorization - Partial Authorization: | |
value: | |
id: AUrBzPBRPdBC9pBtNYM4Vb2m | |
created_at: '2023-10-12T21:13:19.19Z' | |
updated_at: '2023-10-12T21:13:19.19Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
additional_purchase_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2023-10-19T21:13:19.19Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
receipt_last_printed_at: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 1e5b3eca-d460-4c4f-8d31-6832ae6da642 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUrBzPBRPdBC9pBtNYM4Vb2m' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Card Present Authorization - EMV Card: | |
value: | |
id: AUarp7Pz21Low4u2Urw5Ub4W | |
created_at: '2019-04-29T20:44:00.13Z' | |
updated_at: '2022-10-10T05:59:17.59Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 3138 | |
amount_requested: 3138 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: | |
application_identifier: A0000001523010 | |
application_label: DISCOVER | |
application_preferred_name: null | |
application_transaction_counter: '0005' | |
cryptogram: ARCQ F666F8891F870D33 | |
issuer_code_table_index: null | |
pin_verified: false | |
tags: null | |
masked_account_number: '************0059' | |
name: Test Card 05 | |
brand: DISCOVER | |
entry_mode: CHIP_ENTRY | |
payment_type: CREDIT | |
approval_code: '004839' | |
currency: USD | |
device: DVfKLD9GZtsjcJxLtc2yCcfd | |
expires_at: '2019-05-06T20:44:00.13Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MU4LYrniAvqVKUBqcATb7Y7p | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: [] | |
raw: null | |
security_code_verification: null | |
source: PImTHaz7XVPx4M7mhu9x8gkU | |
state: SUCCEEDED | |
tags: | |
TicketNumber: '45878' | |
trace_id: FNX35FSuraeKKJr65wkGVFJni | |
transfer: TRqQCAX7nYHUnkE5YPFTknqd | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUarp7Pz21Low4u2Urw5Ub4W' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRqQCAX7nYHUnkE5YPFTknqd' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVfKLD9GZtsjcJxLtc2yCcfd' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
Card Present Authorization - Non-EMV Card: | |
value: | |
id: AUarp7Pz21Low4u2Urw5Ub4W | |
created_at: '2019-04-29T20:44:00.13Z' | |
updated_at: '2022-10-10T05:59:17.59Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 3138 | |
amount_requested: 3138 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: | |
application_identifier: A0000001523010 | |
application_label: DISCOVER | |
application_preferred_name: null | |
application_transaction_counter: '0005' | |
cryptogram: ARCQ F666F8891F870D33 | |
issuer_code_table_index: null | |
pin_verified: false | |
tags: null | |
masked_account_number: '************0059' | |
name: Test Card 05 | |
brand: DISCOVER | |
entry_mode: CHIP_ENTRY | |
payment_type: CREDIT | |
approval_code: '004839' | |
currency: USD | |
device: DVfKLD9GZtsjcJxLtc2yCcfd | |
expires_at: '2019-05-06T20:44:00.13Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MU4LYrniAvqVKUBqcATb7Y7p | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: [] | |
raw: null | |
security_code_verification: null | |
source: PImTHaz7XVPx4M7mhu9x8gkU | |
state: SUCCEEDED | |
tags: | |
TicketNumber: '45878' | |
trace_id: FNX35FSuraeKKJr65wkGVFJni | |
transfer: TRqQCAX7nYHUnkE5YPFTknqd | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUarp7Pz21Low4u2Urw5Ub4W' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRqQCAX7nYHUnkE5YPFTknqd' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVfKLD9GZtsjcJxLtc2yCcfd' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
Voided Authorization: | |
value: | |
id: AUeYYckKJTrBVu1j8FYLzJ3W | |
created_at: '2022-10-07T18:25:23.30Z' | |
updated_at: '2022-10-07T18:29:59.38Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-14T18:25:23.30Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: true | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 560e44af-5d22-4af2-801e-03d2dad69dc7 | |
transfer: null | |
void_state: SUCCEEDED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUeYYckKJTrBVu1j8FYLzJ3W' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
AuthorizationsList: | |
description: List of Authorization objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/AuthorizationsList' | |
examples: | |
List of Authorizations: | |
value: | |
_embedded: | |
authorizations: | |
- id: AUoCse3evsJWctBbh6hSEsZj | |
created_at: '2022-10-10T06:14:57.84Z' | |
updated_at: '2022-10-10T06:14:58.28Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 150 | |
amount_requested: 150 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: null | |
masked_account_number: null | |
name: null | |
brand: null | |
entry_mode: null | |
payment_type: NONE | |
approval_code: null | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
expires_at: '2022-10-17T06:14:57.84Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: | |
- LaneID 1 does not exist. | |
- 'Authorization AUoCse3evsJWctBbh6hSEsZj could not be submitted. Cause: LaneID 1 does not exist.' | |
- DECLINED | |
raw: | |
approved_amount: 0 | |
convenience_fee_amount: 0 | |
currency_code: None | |
is_approved: false | |
is_offline: false | |
payment_type: None | |
pin_verified: false | |
status_code: None | |
sub_total_amount: 0 | |
tip_amount: 0 | |
total_amount: 0 | |
order_id: FNXhDjLCPDzR33zk8jjTicZv2 | |
lane_id: 1 | |
_errors: | |
- developer_message: "ERROR:POST error\r\nEXCEPTION: LaneID 1 does not exist.\r\n" | |
error_type: '' | |
exception_message: LaneID 1 does not exist. | |
exception_type_full_name: TriPos.Shared.Exceptions.PinPadNotFoundException | |
exception_type_short_name: PinPadNotFoundException | |
user_message: '' | |
_links: [] | |
_processor: | |
logs: | |
- LaneID 1 does not exist. | |
processor_logs: | |
- LaneID 1 does not exist. | |
processor_request_failed: false | |
processor_request_was_approved: false | |
processor_response_code: Unknown | |
_type: authorizationResponse | |
_warnings: [] | |
security_code_verification: null | |
source: PIg2q5tVAPcHpUpbJBNe4Vus | |
state: FAILED | |
tags: | |
order_number: chris123transfer | |
trace_id: FNXhDjLCPDzR33zk8jjTicZv2 | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUoCse3evsJWctBbh6hSEsZj' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
- id: AUuRnfhaBm84RhHyonkHAUrt | |
created_at: '2022-08-01T22:14:13.31Z' | |
updated_at: '2022-08-01T22:14:13.44Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: AP3AB2itAWrrrPVS6spvrGYp | |
currency: USD | |
expires_at: '2022-08-08T22:14:13.31Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant_identity: IDsArLxCm9QGbi2QfhaFrTED | |
messages: [] | |
raw: | |
additional_large_number: 9223372036854776000 | |
value: 100 | |
order_id: e770db75-fbf6-4efb-afe7-57aedd7ac40d | |
security_code_verification: MATCHED | |
source: PIbDnouV59En1yKfYUNLTpG9 | |
state: SUCCEEDED | |
tags: {} | |
trace_id: e770db75-fbf6-4efb-afe7-57aedd7ac40d | |
transfer: null | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUuRnfhaBm84RhHyonkHAUrt' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/AP3AB2itAWrrrPVS6spvrGYp' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsArLxCm9QGbi2QfhaFrTED' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/authorizations?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/authorizations?offset=633380&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 633397 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
CreatePaymentInstrumentToken: | |
description: Token response object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PaymentInstrumentToken' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Device: | |
description: Single Device object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Device' | |
examples: | |
Device: | |
value: | |
id: DVsEanpBtsAVvCHbNXkFaH6f | |
created_at: '2019-03-01T02:27:20.366Z' | |
updated_at: '2022-04-05T18:48:40.383Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: false | |
prompt_manual_entry: true | |
prompt_signature: AMOUNT | |
signature_threshold_amount: 10 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: Mike Jones | |
enabled: false | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: Johnnys Juice Shop | |
serial_number: '343434343' | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Activated (DATACAP_V1): | |
value: | |
id: DV8EVnpCwHwB9Dk3xTysgt5d | |
created_at: '2022-06-06T03:59:42.415Z' | |
updated_at: '2022-06-06T03:59:42.420647Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: true | |
prompt_manual_entry: false | |
prompt_signature: NEVER | |
signature_threshold_amount: 0 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: John Smith | |
enabled: true | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: 'Finix triPOS #1' | |
serial_number: '111023985764' | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DV8EVnpCwHwB9Dk3xTysgt5d' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Activated (TRIPOS_CLOUD_V1): | |
value: | |
id: DV8EVnpCwHwB9Dk3xTysgt5d | |
created_at: '2022-06-06T03:59:42.415Z' | |
updated_at: '2022-06-06T03:59:42.420647Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: true | |
prompt_manual_entry: false | |
prompt_signature: NEVER | |
signature_threshold_amount: 0 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: John Smith | |
enabled: true | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: 'Finix triPOS #1' | |
serial_number: null | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DV8EVnpCwHwB9Dk3xTysgt5d' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Idle Message Set: | |
value: | |
id: DV8EVnpCwHwB9Dk3xTysgt5d | |
created_at: '2022-06-06T03:59:42.415Z' | |
updated_at: '2022-06-06T03:59:42.420647Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: true | |
prompt_manual_entry: false | |
prompt_signature: NEVER | |
signature_threshold_amount: 0 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: John Smith | |
enabled: false | |
idle_message: Finix Flowers | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: 'Finix triPOS #1' | |
serial_number: null | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DV8EVnpCwHwB9Dk3xTysgt5d' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Connection Check: | |
value: | |
id: DV8EVnpCwHwB9Dk3xTysgt5d | |
created_at: '2022-06-06T03:59:42.415Z' | |
updated_at: '2022-06-06T03:59:42.420647Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: true | |
prompt_manual_entry: false | |
prompt_signature: NEVER | |
signature_threshold_amount: 0 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: John Smith | |
enabled: false | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: 'Finix triPOS #1' | |
serial_number: null | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DV8EVnpCwHwB9Dk3xTysgt5d' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Deactivated: | |
value: | |
id: DV8EVnpCwHwB9Dk3xTysgt5d | |
created_at: '2022-06-06T03:59:42.415Z' | |
updated_at: '2022-06-06T03:59:42.420647Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: true | |
prompt_manual_entry: false | |
prompt_signature: NEVER | |
signature_threshold_amount: 0 | |
bypass_device_on_capture: false | |
connection: OPEN | |
description: John Smith | |
enabled: false | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: 'Finix triPOS #1' | |
serial_number: null | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DV8EVnpCwHwB9Dk3xTysgt5d' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
Device - Update Details: | |
value: | |
id: DVsEanpBtsAVvCHbNXkFaH6f | |
created_at: '2019-03-01T02:27:20.366Z' | |
updated_at: '2022-04-05T18:48:40.383Z' | |
configuration_details: | |
allow_debit: true | |
check_for_duplicate_transactions: true | |
prompt_amount_confirmation: false | |
prompt_manual_entry: true | |
prompt_signature: NEVER | |
signature_threshold_amount: 10 | |
bypass_device_on_capture: true | |
connection: OPEN | |
description: Flowers | |
enabled: false | |
idle_message: null | |
merchant: MUu56ZGx3Xb6U9gAqKfgNisd | |
model: MX915 | |
name: Finix Flowers - triPOS | |
serial_number: '343434343' | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/transfers' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/authorizations' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Dispute: | |
description: Single Dispute object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Dispute' | |
examples: | |
Dispute: | |
value: | |
id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
evidence_submitted: CHARGEBACK | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
response_state: ACCEPTED | |
state: WON | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
Dispute - Inquiry: | |
value: | |
id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
evidence_submitted: INQUIRY | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
response_state: NEEDS_RESPONSE | |
state: INQUIRY | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
Dispute - Chargeback: | |
value: | |
id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
evidence_submitted: CHARGEBACK | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
response_state: RESPONDED | |
state: PENDING | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
Dispute - Accepted: | |
value: | |
id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
evidence_submitted: INQUIRY | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
response_state: ACCEPTED | |
state: INQUIRY | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
Dispute - Tags: | |
value: | |
id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
evidence_submitted: CHARGEBACK | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
response_state: ACCEPTED | |
state: WON | |
tags: | |
order_number: 41BFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
DisputeEvidence: | |
description: Single Evidence object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/DisputeEvidence' | |
examples: | |
Dispute Evidence: | |
value: | |
id: DF58kdVTa5eMQUjcXH2F7DH4 | |
created_at: '2022-08-15T21:37:04.41Z' | |
updated_at: '2022-08-15T21:45:00.74Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute: DIs7yQRkHDdMYhurzYz72SFk | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
state: SUCCEEDED | |
tags: | |
file-extension: .png | |
content-type: image/png | |
file-name: test_file.png | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DF58kdVTa5eMQUjcXH2F7DH4' | |
Dispute - Tags: | |
value: | |
id: DF58kdVTa5eMQUjcXH2F7DH4 | |
created_at: '2022-08-15T21:37:04.41Z' | |
updated_at: '2022-08-15T21:45:00.74Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute: DIs7yQRkHDdMYhurzYz72SFk | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
state: SUCCEEDED | |
tags: | |
order_number: 41BFASJSAKAS | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DF58kdVTa5eMQUjcXH2F7DH4' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
DisputeEvidenceList: | |
description: List of Evidence objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/DisputeEvidenceList' | |
examples: | |
List of Dispute Evidence: | |
value: | |
_embedded: | |
evidences: | |
- id: DFcVgoEuDeWn4eSvdZca8Hf | |
created_at: '2022-10-06T20:22:54.93Z' | |
updated_at: '2022-10-06T20:30:00.63Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute: DIs7yQRkHDdMYhurzYz72SFk | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
state: SUCCEEDED | |
tags: | |
file-extension: .png | |
content-type: image/png | |
file-name: test_file.png | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DFcVgoEuDeWn4eSvdZca8Hf' | |
- id: DFx3tddpTC568GjukRFGZpDp | |
created_at: '2022-09-14T17:36:33.84Z' | |
updated_at: '2022-09-14T17:45:00.51Z' | |
dispute: DIs7yQRkHDdMYhurzYz72SFk | |
state: SUCCEEDED | |
tags: | |
file-extension: .png | |
content-type: image/png | |
file-name: test_file.png | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence/DFx3tddpTC568GjukRFGZpDp' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence?offset=1160&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
limit: 100 | |
next_cursor: DFs7yQRkHDdMYhurzYz72SFk | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
DisputesList: | |
description: List of Disputes | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/DisputesList' | |
examples: | |
List of Disputes: | |
value: | |
_embedded: | |
disputes: | |
- id: DIb72obRhTmPdMG1VxDKFLrb | |
created_at: '2022-07-14T19:40:06.52Z' | |
updated_at: '2022-07-14T19:40:06.11Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
message: null | |
occurred_at: '2022-07-14T19:39:00.77Z' | |
reason: FRAUD | |
respond_by: '2022-07-21T19:40:06.51Z' | |
state: PENDING | |
tags: | |
test: sale | |
transfer: TRkhvS4GfMKxaHyBBdkPSx6g | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIb72obRhTmPdMG1VxDKFLrb' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkhvS4GfMKxaHyBBdkPSx6g' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIb72obRhTmPdMG1VxDKFLrb/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIb72obRhTmPdMG1VxDKFLrb/adjustment_transfers' | |
- id: DIuk8T4ayQdmxewz8EDLHe49 | |
created_at: '2022-06-15T16:14:03.95Z' | |
updated_at: '2022-06-15T16:14:03.64Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
message: null | |
occurred_at: '2022-06-15T16:13:04.09Z' | |
reason: FRAUD | |
respond_by: '2022-06-22T16:14:03.94Z' | |
state: PENDING | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TR27JnLR2pKDXjVVcGBKrjwU | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIuk8T4ayQdmxewz8EDLHe49' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR27JnLR2pKDXjVVcGBKrjwU' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIuk8T4ayQdmxewz8EDLHe49/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIuk8T4ayQdmxewz8EDLHe49/adjustment_transfers' | |
- id: DIs7yQRkHDdMYhurzYz72SFk | |
created_at: '2022-01-27T07:43:03.74Z' | |
updated_at: '2022-09-16T22:21:54.75Z' | |
action: null | |
amount: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
dispute_details: | |
arn: '123' | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
message: null | |
occurred_at: '2022-01-27T07:42:48.56Z' | |
reason: FRAUD | |
respond_by: '2022-02-03T07:43:03.73Z' | |
state: WON | |
tags: | |
order_number: 21DFASJSAKAS | |
transfer: TRoTrJ3kqNTFh1P2FJ7A36Ky | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRoTrJ3kqNTFh1P2FJ7A36Ky' | |
evidence: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/evidence' | |
adjustment_transfers: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
limit: 100 | |
next_cursor: DIs7yQRkHDdMYhurzYz72SFk | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Error406NotAcceptable: | |
description: Not Acceptable | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error406NotAcceptable' | |
examples: {} | |
Error422InvalidField: | |
description: Invalid field | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error422InvalidFieldList' | |
ErrorForbidden403: | |
description: Forbidden | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error403ForbiddenList' | |
ErrorMerchantIdentityDisabled: | |
description: Merchant identity disabled error | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ErrorGeneric' | |
ErrorMethodNotAllowed: | |
description: 405 - Method not allowed | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ErrorGeneric' | |
ErrorNotFound: | |
description: Object does not exist | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error404NotFoundList' | |
ErrorPaymentRequired: | |
description: Payment Required | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ErrorGeneric' | |
ErrorTransfers402: | |
description: 402 - Payment required | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error402PaymentRequired' | |
ErrorUnauthorized: | |
description: Authentication information is missing or invalid | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Error401Unauthorized' | |
ErrorUnprocessableEntity: | |
description: Error | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ErrorGeneric' | |
Fee: | |
description: Single Fee object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Fee' | |
examples: | |
Fee: | |
value: | |
id: FEtSD9oNjoCtJaN2C1FwhZ29 | |
created_at: '2022-08-15T23:14:03.37Z' | |
updated_at: '2022-08-15T23:14:03.37Z' | |
amount: 100 | |
currency: USD | |
display_name: null | |
fee_subtype: PLATFORM_FEE | |
fee_type: CARD_FIXED | |
label: null | |
linked_id: TR7m4FqzubzFvPJf4WEmkEEv | |
linked_type: TRANSFER | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fees/FEtSD9oNjoCtJaN2C1FwhZ29' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7m4FqzubzFvPJf4WEmkEEv' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
FeeProfile: | |
description: Fee profile | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/FeeProfile' | |
examples: | |
Fee Profile: | |
value: | |
id: FPq6PQ9pHsab66fKMmjQ7jb5 | |
created_at: '2022-01-27T07:37:38.66Z' | |
updated_at: '2022-01-27T07:37:38.66Z' | |
ach_basis_points: 300 | |
ach_credit_return_fixed_fee: null | |
ach_debit_return_fixed_fee: null | |
ach_fixed_fee: 30 | |
american_express_assessment_basis_points: null | |
american_express_basis_points: null | |
american_express_charge_interchange: null | |
american_express_externally_funded_basis_points: null | |
american_express_externally_funded_fixed_fee: null | |
american_express_fixed_fee: null | |
ancillary_fixed_fee_primary: null | |
ancillary_fixed_fee_secondary: null | |
application: APgPDQrLD52TYvqazjHJJchM | |
basis_points: 200 | |
charge_interchange: false | |
diners_club_basis_points: null | |
diners_club_charge_interchange: null | |
diners_club_fixed_fee: null | |
discover_assessments_basis_points: null | |
discover_basis_points: null | |
discover_charge_interchange: null | |
discover_data_usage_fixed_fee: null | |
discover_externally_funded_basis_points: null | |
discover_externally_funded_fixed_fee: null | |
discover_fixed_fee: null | |
discover_network_authorization_fixed_fee: null | |
dispute_fixed_fee: null | |
dispute_inquiry_fixed_fee: null | |
externally_funded_basis_points: null | |
externally_funded_fixed_fee: null | |
fixed_fee: 100 | |
jcb_basis_points: null | |
jcb_charge_interchange: null | |
jcb_fixed_fee: null | |
mastercard_acquirer_fees_basis_points: null | |
mastercard_assessments_over1k_basis_points: null | |
mastercard_assessments_under1k_basis_points: null | |
mastercard_basis_points: null | |
mastercard_charge_interchange: null | |
mastercard_fixed_fee: null | |
qualified_tiers: null | |
rounding_mode: TRANSACTION | |
tags: {} | |
visa_acquirer_processing_fixed_fee: null | |
visa_assessments_basis_points: null | |
visa_base_II_credit_voucher_fixed_fee: null | |
visa_base_II_system_file_transmission_fixed_fee: null | |
visa_basis_points: null | |
visa_charge_interchange: null | |
visa_credit_voucher_fixed_fee: null | |
visa_fixed_fee: null | |
visa_kilobyte_access_fixed_fee: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPq6PQ9pHsab66fKMmjQ7jb5' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
FeeProfilesList: | |
description: List of fee profiles | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/FeeProfilesList' | |
examples: | |
List of Fee Profiles: | |
value: | |
_embedded: | |
fee_profiles: | |
- id: FPq6PQ9pHsab66fKMmjQ7jb5 | |
created_at: '2022-01-27T07:37:38.66Z' | |
updated_at: '2022-01-27T07:37:38.66Z' | |
ach_basis_points: 300 | |
ach_credit_return_fixed_fee: null | |
ach_debit_return_fixed_fee: null | |
ach_fixed_fee: 30 | |
american_express_assessment_basis_points: null | |
american_express_basis_points: null | |
american_express_charge_interchange: null | |
american_express_externally_funded_basis_points: null | |
american_express_externally_funded_fixed_fee: null | |
american_express_fixed_fee: null | |
ancillary_fixed_fee_primary: null | |
ancillary_fixed_fee_secondary: null | |
application: APgPDQrLD52TYvqazjHJJchM | |
basis_points: 200 | |
charge_interchange: false | |
diners_club_basis_points: null | |
diners_club_charge_interchange: null | |
diners_club_fixed_fee: null | |
discover_assessments_basis_points: null | |
discover_basis_points: null | |
discover_charge_interchange: null | |
discover_data_usage_fixed_fee: null | |
discover_externally_funded_basis_points: null | |
discover_externally_funded_fixed_fee: null | |
discover_fixed_fee: null | |
discover_network_authorization_fixed_fee: null | |
dispute_fixed_fee: null | |
dispute_inquiry_fixed_fee: null | |
externally_funded_basis_points: null | |
externally_funded_fixed_fee: null | |
fixed_fee: 100 | |
jcb_basis_points: null | |
jcb_charge_interchange: null | |
jcb_fixed_fee: null | |
mastercard_acquirer_fees_basis_points: null | |
mastercard_assessments_over1k_basis_points: null | |
mastercard_assessments_under1k_basis_points: null | |
mastercard_basis_points: null | |
mastercard_charge_interchange: null | |
mastercard_fixed_fee: null | |
qualified_tiers: null | |
rounding_mode: TRANSACTION | |
tags: {} | |
visa_acquirer_processing_fixed_fee: null | |
visa_assessments_basis_points: null | |
visa_base_II_credit_voucher_fixed_fee: null | |
visa_base_II_system_file_transmission_fixed_fee: null | |
visa_basis_points: null | |
visa_charge_interchange: null | |
visa_credit_voucher_fixed_fee: null | |
visa_fixed_fee: null | |
visa_kilobyte_access_fixed_fee: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPq6PQ9pHsab66fKMmjQ7jb5' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
- id: FPvCQUcnsueN3Bc3zR1qCBG8 | |
created_at: '2022-01-27T07:37:36.69Z' | |
updated_at: '2022-01-27T07:37:36.69Z' | |
ach_basis_points: 300 | |
ach_credit_return_fixed_fee: null | |
ach_debit_return_fixed_fee: null | |
ach_fixed_fee: 30 | |
american_express_assessment_basis_points: null | |
american_express_basis_points: null | |
american_express_charge_interchange: null | |
american_express_externally_funded_basis_points: null | |
american_express_externally_funded_fixed_fee: null | |
american_express_fixed_fee: null | |
ancillary_fixed_fee_primary: null | |
ancillary_fixed_fee_secondary: null | |
application: APgPDQrLD52TYvqazjHJJchM | |
basis_points: 200 | |
charge_interchange: false | |
diners_club_basis_points: null | |
diners_club_charge_interchange: null | |
diners_club_fixed_fee: null | |
discover_assessments_basis_points: null | |
discover_basis_points: null | |
discover_charge_interchange: null | |
discover_data_usage_fixed_fee: null | |
discover_externally_funded_basis_points: null | |
discover_externally_funded_fixed_fee: null | |
discover_fixed_fee: null | |
discover_network_authorization_fixed_fee: null | |
dispute_fixed_fee: null | |
dispute_inquiry_fixed_fee: null | |
externally_funded_basis_points: null | |
externally_funded_fixed_fee: null | |
fixed_fee: 100 | |
jcb_basis_points: null | |
jcb_charge_interchange: null | |
jcb_fixed_fee: null | |
mastercard_acquirer_fees_basis_points: null | |
mastercard_assessments_over1k_basis_points: null | |
mastercard_assessments_under1k_basis_points: null | |
mastercard_basis_points: null | |
mastercard_charge_interchange: null | |
mastercard_fixed_fee: null | |
qualified_tiers: null | |
rounding_mode: TRANSACTION | |
tags: {} | |
visa_acquirer_processing_fixed_fee: null | |
visa_assessments_basis_points: null | |
visa_base_II_credit_voucher_fixed_fee: null | |
visa_base_II_system_file_transmission_fixed_fee: null | |
visa_basis_points: null | |
visa_charge_interchange: null | |
visa_credit_voucher_fixed_fee: null | |
visa_fixed_fee: null | |
visa_kilobyte_access_fixed_fee: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 2 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
FeesList: | |
description: List of Fee objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/FeesList' | |
examples: | |
List of Fees: | |
value: | |
_embedded: | |
fees: | |
- id: FEvQN3v5mhA2Ttc78hzjLV3j | |
created_at: '2022-10-11T03:25:04.79Z' | |
updated_at: '2022-10-11T03:25:04.79Z' | |
amount: 13243 | |
currency: USD | |
display_name: null | |
fee_subtype: PLATFORM_FEE | |
fee_type: CARD_BASIS_POINTS | |
label: null | |
linked_id: TR61nQ89c8U5i7uAvwmSuLnv | |
linked_type: TRANSFER | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fees/FEvQN3v5mhA2Ttc78hzjLV3j' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv' | |
- id: FEkuQHsAipobyobNSizt4ySJ | |
created_at: '2022-10-10T05:27:04.75Z' | |
updated_at: '2022-10-10T05:27:04.75Z' | |
amount: 2 | |
currency: USD | |
display_name: null | |
fee_subtype: PLATFORM_FEE | |
fee_type: CARD_BASIS_POINTS | |
label: null | |
linked_id: TR3s5fgSyEZ1SnweXKxyWJ6R | |
linked_type: TRANSFER | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fees/FEkuQHsAipobyobNSizt4ySJ' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3s5fgSyEZ1SnweXKxyWJ6R' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/fees?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/fees?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/fees?offset=15100&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 15114 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
IdentitiesList: | |
description: List of Identity objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/IdentitiesList' | |
examples: | |
List of Identities: | |
value: | |
_embedded: | |
identities: | |
- id: IDrNRsZ2miEQcmGHCpo4rBQr | |
created_at: '2022-08-16T18:44:27.46Z' | |
updated_at: '2022-08-16T18:44:27.46Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
entity: | |
amex_mid: null | |
annual_card_volume: 12000000 | |
business_address: | |
line1: 741 Douglass St | |
line2: Apartment 8 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
business_name: Petes Coffee | |
business_phone: +1 (408) 756-4497 | |
business_tax_id_provided: true | |
business_type: INDIVIDUAL_SOLE_PROPRIETORSHIP | |
default_statement_descriptor: Petes Coffee | |
discover_mid: null | |
dob: | |
day: 27 | |
month: 6 | |
year: 1978 | |
doing_business_as: Petes Coffee | |
email: user@example.org | |
first_name: dwayne | |
has_accepted_credit_cards_previously: true | |
incorporation_date: | |
day: 27 | |
month: 6 | |
year: 1978 | |
last_name: xbc | |
max_transaction_amount: 12000000 | |
mcc: '4900' | |
ownership_type: PRIVATE | |
personal_address: | |
line1: 741 Douglass St | |
line2: Apartment 7 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
phone: '14158885080' | |
principal_percentage_ownership: 50 | |
short_business_name: null | |
tax_authority: null | |
tax_id_provided: true | |
title: CEO | |
url: www.PetesCoffee.com | |
identity_roles: [] | |
tags: | |
test_key_103: test_val_103 | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/verifications' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/merchants' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/settlements' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/transfers' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/payment_instruments' | |
associated_identities: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/associated_identities' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDrNRsZ2miEQcmGHCpo4rBQr/disputes' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDf33pdVaTZGXVFNccdKvaPu/associated_identities?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Identity: | |
description: Single Identity object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Identity' | |
examples: | |
Identity - Merchant: | |
value: | |
id: ID5ZbV3hkc7eLxNhmFjfrrYA | |
created_at: '2023-10-24T23:19:18.35Z' | |
updated_at: '2023-10-24T23:19:18.35Z' | |
additional_underwriting_data: | |
refund_policy: MERCHANDISE_EXCHANGE_ONLY | |
credit_check_ip_address: 42.1.1.113 | |
card_volume_distribution: | |
card_present_percentage: 30 | |
mail_order_telephone_order_percentage: 10 | |
ecommerce_percentage: 60 | |
average_ach_transfer_amount: 200000 | |
average_card_transfer_amount: 200000 | |
merchant_agreement_accepted: true | |
merchant_agreement_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) | |
merchant_agreement_ip_address: 42.1.1.113 | |
annual_ach_volume: 200000 | |
credit_check_allowed: true | |
business_description: SB3 vegan cafe | |
credit_check_user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
volume_distribution_by_business_type: | |
other_volume_percentage: 0 | |
consumer_to_consumer_volume_percentage: 0 | |
business_to_consumer_volume_percentage: 0 | |
business_to_business_volume_percentage: 100 | |
person_to_person_volume_percentage: 0 | |
credit_check_timestamp: '2021-04-28T16:42:55Z' | |
merchant_agreement_timestamp: '2021-04-28T16:42:55Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
entity: | |
ach_max_transaction_amount: 1000000 | |
amex_mid: null | |
annual_card_volume: 12000000 | |
business_address: | |
line1: 741 Douglass St | |
line2: Apartment 8 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
business_name: Finix Flowers | |
business_phone: +1 (408) 756-4497 | |
business_tax_id_provided: true | |
business_type: INDIVIDUAL_SOLE_PROPRIETORSHIP | |
default_statement_descriptor: Finix Flowers | |
discover_mid: null | |
dob: | |
day: 27 | |
month: 6 | |
year: 1978 | |
doing_business_as: Finix Flowers | |
email: user@example.org | |
first_name: John | |
has_accepted_credit_cards_previously: true | |
incorporation_date: | |
day: 27 | |
month: 6 | |
year: 1978 | |
last_name: Smith | |
max_transaction_amount: 1200000 | |
mcc: '4900' | |
ownership_type: PRIVATE | |
personal_address: | |
line1: 741 Douglass St | |
line2: Apartment 7 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
phone: '14158885080' | |
principal_percentage_ownership: 50 | |
short_business_name: null | |
tax_authority: null | |
tax_id_provided: true | |
title: CEO | |
url: 'https://www.finix.com' | |
identity_roles: | |
- SELLER | |
tags: | |
Studio Rating: '4.7' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/verifications' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/merchants' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/settlements' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/transfers' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/payment_instruments' | |
associated_identities: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/associated_identities' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID5ZbV3hkc7eLxNhmFjfrrYA/disputes' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
Identity - Buyer: | |
value: | |
id: IDa5PTnZACanPDci1pEEHp9t | |
created_at: '2023-10-24T23:19:46.39Z' | |
updated_at: '2023-10-24T23:19:46.39Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
entity: | |
ach_max_transaction_amount: 0 | |
amex_mid: null | |
annual_card_volume: 0 | |
business_address: null | |
business_name: null | |
business_phone: null | |
business_tax_id_provided: false | |
business_type: null | |
default_statement_descriptor: null | |
discover_mid: null | |
dob: null | |
doing_business_as: null | |
email: finix_example@finix.com | |
first_name: John | |
has_accepted_credit_cards_previously: false | |
incorporation_date: null | |
last_name: Smith | |
max_transaction_amount: 0 | |
mcc: null | |
ownership_type: null | |
personal_address: | |
line1: 741 Douglass St | |
line2: Apartment 7 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
phone: '7145677613' | |
principal_percentage_ownership: null | |
short_business_name: null | |
tax_authority: null | |
tax_id_provided: false | |
title: null | |
url: null | |
identity_roles: [] | |
tags: | |
key: value | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/verifications' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/merchants' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/settlements' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/transfers' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/payment_instruments' | |
associated_identities: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/associated_identities' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDa5PTnZACanPDci1pEEHp9t/disputes' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
Associated Identity: | |
value: | |
id: ID8v1JtSq1mVoQRcaAb3SWHQ | |
created_at: '2023-01-13T07:02:49.68Z' | |
updated_at: '2023-01-13T07:02:49.68Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
entity: | |
amex_mid: null | |
annual_card_volume: 0 | |
business_address: null | |
business_name: null | |
business_phone: null | |
business_tax_id_provided: false | |
business_type: null | |
default_statement_descriptor: null | |
discover_mid: null | |
dob: null | |
doing_business_as: null | |
email: null | |
first_name: null | |
has_accepted_credit_cards_previously: false | |
incorporation_date: null | |
last_name: null | |
max_transaction_amount: 0 | |
mcc: null | |
ownership_type: null | |
personal_address: null | |
phone: null | |
principal_percentage_ownership: 25 | |
short_business_name: null | |
tax_authority: null | |
tax_id_provided: false | |
title: null | |
url: null | |
tags: {} | |
identity_roles: [] | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/verifications' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/merchants' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/settlements' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/transfers' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/payment_instruments' | |
associated_identities: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/associated_identities' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID8v1JtSq1mVoQRcaAb3SWHQ/disputes' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Merchant: | |
description: Single Merchant object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Merchant' | |
examples: | |
Merchant: | |
value: | |
id: MUucec6fHeaWo3VHYoSkUySM | |
created_at: '2022-01-27T07:36:58.19Z' | |
updated_at: '2022-10-06T20:25:24.06Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: false | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: RECONCILIATION | |
gross_settlement_enabled: false | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
level_two_level_three_data_enabled: false | |
mcc: '4900' | |
merchant_name: Bobs Burgers | |
merchant_profile: MPzW2oRPtkLxK3fymcMACFi | |
mid: FNXh6htoPnfwmgGdvaG4L67Q1 | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXh6htoPnfwmgGdvaG4L67Q1 | |
api_key: secretValue | |
ready_to_settle_upon: RECONCILIATION | |
rent_surcharges_enabled: false | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VIxfDrRKZZzkCDDbeCT15oDN | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUht1bsAEcihT9HA55Tet5dk' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDoZy2xjNQyWCkN5nKZbVp6x' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUht1bsAEcihT9HA55Tet5dk/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPh4vD8hWCtqHeJ8JgG4Tsva' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIr27e4C5AWxgvLnyGJmdZQe' | |
Merchant - Card Present Enabled: | |
value: | |
id: MUu56ZGx3Xb6U9gAqKfgNisd | |
created_at: '2019-03-01T01:57:19.95Z' | |
updated_at: '2019-05-15T18:10:03.00Z' | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: false | |
creating_transfer_from_report_enabled: false | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: RECONCILIATION | |
gross_settlement_enabled: false | |
identity: IDsbTBawhnLBAVeinRb84vFR | |
level_two_level_three_data_enabled: false | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MPcMKhfF9rhWT2JWeUKzQVy2 | |
mid: '4445029863321' | |
onboarding_state: REJECTED | |
processing_enabled: true | |
processor: VANTIV_V1 | |
processor_details: | |
acceptor_id: '874767464' | |
default_terminal_id: X6600507601 | |
mid: '4445029863321' | |
account_token: 811D0B76DEC8CCD1903D2772B68DA0CACA84BF56B5A6EE61EC05FE126EA63EF1B979A401 | |
account_id: '1056772' | |
merchant_ident_string: '4445029863321' | |
id: '193448212' | |
vantiv_merchant_id: '4445029863321' | |
ready_to_settle_upon: RECONCILIATION | |
rent_surcharges_enabled: false | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VImHURoSqEvAf9haPD6zeHJx | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUu56ZGx3Xb6U9gAqKfgNisd/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPcMKhfF9rhWT2JWeUKzQVy2' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VImHURoSqEvAf9haPD6zeHJx' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
MerchantProfile: | |
description: Single merchant profile object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/MerchantProfile' | |
examples: | |
Merchant Profile: | |
value: | |
id: MPsdo8WPP5erWzfPwMjYjVy3 | |
created_at: '2022-08-15T21:37:47.26Z' | |
updated_at: '2022-08-15T21:38:24.02Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
fee_profile: null | |
payout_profile: null | |
risk_profile: RPwAziDZginXDWuuiDSaA3wr | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPsdo8WPP5erWzfPwMjYjVy3' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
risk_profile: | |
href: 'https://finix.sandbox-payments-api.com/risk_profiles/RPwAziDZginXDWuuiDSaA3wr' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
MerchantProfilesList: | |
description: Single merchant profile object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/MerchantProfilesList' | |
examples: | |
List of Merchant Profiles: | |
value: | |
_embedded: | |
merchant_profiles: | |
- id: MPnXB4UBGtSUfxwA41z2Hqid | |
created_at: '2022-10-10T05:20:18.12Z' | |
updated_at: '2022-10-10T05:21:01.42Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
fee_profile: null | |
payout_profile: PO8ki51uFGkLYaWyBVJ7oyAt | |
risk_profile: RPqzvQLoHk37r74aE6NZ4aXt | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPnXB4UBGtSUfxwA41z2Hqid' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
risk_profile: | |
href: 'https://finix.sandbox-payments-api.com/risk_profiles/RPqzvQLoHk37r74aE6NZ4aXt' | |
- id: MPo85BavSYVrkDn57BLh1JTs | |
created_at: '2022-09-21T17:46:06.29Z' | |
updated_at: '2022-09-21T17:46:07.75Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
fee_profile: null | |
payout_profile: PO9AtdBb4FUQqbMm3SAyoX3z | |
risk_profile: RP5PUJVynFoHibX6eHtfebV3 | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPo85BavSYVrkDn57BLh1JTs' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
risk_profile: | |
href: 'https://finix.sandbox-payments-api.com/risk_profiles/RP5PUJVynFoHibX6eHtfebV3' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles?offset=1660&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1671 | |
MerchantsList: | |
description: List of Merchants objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/MerchantsList' | |
examples: | |
List of Merchants: | |
value: | |
_embedded: | |
merchants: | |
- id: MUk3936kZweevCrjyHLN1vsu | |
created_at: '2022-10-10T05:20:18.12Z' | |
updated_at: '2022-10-10T05:21:01.42Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: false | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: RECONCILIATION | |
gross_settlement_enabled: false | |
identity: IDx2ZETjYiWkbitkYdFt1yLF | |
level_two_level_three_data_enabled: false | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MPnXB4UBGtSUfxwA41z2Hqid | |
mid: FNXqeJt93ojP2cn1VUYtXANCF | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXqeJt93ojP2cn1VUYtXANCF | |
api_key: secretValue | |
ready_to_settle_upon: RECONCILIATION | |
rent_surcharges_enabled: false | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VItUgbe9V8vpgSaJAriLDxER | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUk3936kZweevCrjyHLN1vsu' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDx2ZETjYiWkbitkYdFt1yLF' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUk3936kZweevCrjyHLN1vsu/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPnXB4UBGtSUfxwA41z2Hqid' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VItUgbe9V8vpgSaJAriLDxER' | |
- id: MU951dfkbH7nqVm4G91yb2au | |
created_at: '2022-09-21T17:46:06.29Z' | |
updated_at: '2022-09-21T17:46:09.45Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: false | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: RECONCILIATION | |
gross_settlement_enabled: false | |
identity: ID4YPdRriet29ZhaiVa6qhJ5 | |
level_two_level_three_data_enabled: false | |
mcc: '4900' | |
merchant_name: Petes Coffee | |
merchant_profile: MPo85BavSYVrkDn57BLh1JTs | |
mid: FNXkitpwdmgMJ8Vz9FxKBCSza | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXkitpwdmgMJ8Vz9FxKBCSza | |
api_key: secretValue | |
ready_to_settle_upon: RECONCILIATION | |
rent_surcharges_enabled: false | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key: value_2 | |
verification: VIrjCZHf8v8arhbgPTikKmpp | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MU951dfkbH7nqVm4G91yb2au' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID4YPdRriet29ZhaiVa6qhJ5' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MU951dfkbH7nqVm4G91yb2au/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPo85BavSYVrkDn57BLh1JTs' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIrjCZHf8v8arhbgPTikKmpp' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/merchants?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/merchants?offset=1660&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1669 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
NoContent: | |
description: No content | |
PaymentInstrument: | |
description: Single Payment Instrument object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PaymentInstrument' | |
descriminator: | |
propertyName: type | |
examples: | |
Payment Instrument - Card: | |
value: | |
id: PI8uU6wfi6hqBoWmzm9L4F2b | |
created_at: '2022-10-11T01:42:22.32Z' | |
updated_at: '2022-10-11T01:42:22.32Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRiCenDk2SoRng7WjQTr7RJY | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: PAYMENT_CARD | |
address: | |
line1: 900 Metro Center Blv | |
line2: null | |
city: San Francisco | |
region: CA | |
postal_code: '94404' | |
country: USA | |
address_verification: UNKNOWN | |
bin: '520082' | |
brand: MASTERCARD | |
card_type: DEBIT | |
expiration_month: 12 | |
expiration_year: 2029 | |
issuer_country: NON_USA | |
last_four: '8210' | |
name: John Smith | |
security_code_verification: UNKNOWN | |
tags: | |
card_name: Business Card | |
type: PAYMENT_CARD | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI8uU6wfi6hqBoWmzm9L4F2b' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI8uU6wfi6hqBoWmzm9L4F2b/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI8uU6wfi6hqBoWmzm9L4F2b/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI8uU6wfi6hqBoWmzm9L4F2b/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
updates: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI8uU6wfi6hqBoWmzm9L4F2b/updates' | |
Payment Instrument - Bank Account: | |
value: | |
id: PI3AbkuRR1JbT5kPiGQCXvD9 | |
created_at: '2022-10-11T01:42:53.29Z' | |
updated_at: '2022-10-11T01:42:53.29Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRd5moHxL3Ltuvk4cczxetCg | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: NOT_ATTEMPTED | |
bank_code: '123123123' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: John | |
tags: | |
Bank Account: Company Account | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
Payment Instrument - Token: | |
value: | |
id: PImmCg3Po7oNi7jaZcXhfkEu | |
created_at: '2022-10-10T05:32:17.78Z' | |
updated_at: '2022-10-10T05:32:17.78Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRiCenDk2SoRng7WjQTr7RJY | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: PAYMENT_CARD | |
address: | |
line1: 900 Metro Center Blv | |
line2: null | |
city: San Francisco | |
region: CA | |
postal_code: '94404' | |
country: USA | |
address_verification: UNKNOWN | |
bin: '520082' | |
brand: MASTERCARD | |
card_type: DEBIT | |
expiration_month: 12 | |
expiration_year: 2029 | |
issuer_country: NON_USA | |
last_four: '8210' | |
name: Amy White | |
security_code_verification: UNKNOWN | |
tags: | |
card_name: Business Card | |
type: PAYMENT_CARD | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImmCg3Po7oNi7jaZcXhfkEu' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImmCg3Po7oNi7jaZcXhfkEu/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImmCg3Po7oNi7jaZcXhfkEu/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImmCg3Po7oNi7jaZcXhfkEu/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
updates: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImmCg3Po7oNi7jaZcXhfkEu/updates' | |
Payment Instrument - Apple Pay: | |
value: | |
id: PImE5ZhGZJNFy14DtX8wX6f6 | |
created_at: '2022-10-10T05:36:55.27Z' | |
updated_at: '2022-10-10T05:36:55.27Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPR88YBDbK4TqYMUNU8t8fbeQ | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: APPLE_PAY | |
bin: '370382' | |
brand: AMERICAN_EXPRESS | |
card_type: UNKNOWN | |
expiration_month: 11 | |
expiration_year: 2024 | |
issuer_country: UNKNOWN | |
last_four: '8576' | |
name: John Smith | |
tags: {} | |
type: APPLE_PAY | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImE5ZhGZJNFy14DtX8wX6f6' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImE5ZhGZJNFy14DtX8wX6f6/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImE5ZhGZJNFy14DtX8wX6f6/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImE5ZhGZJNFy14DtX8wX6f6/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
Payment Instrument - Google Pay: | |
value: | |
id: PIf8dyFFcEGBqPhaG22hPyYs | |
created_at: '2022-10-10T05:36:55.27Z' | |
updated_at: '2022-10-10T05:36:55.27Z' | |
application: APeUfzF5qdNkBCtdgcf3333n | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRrcobjtdU98gr4sjiqYR1Qg | |
identity: ID78Fh8mcnnzukVzbdoyex5y | |
instrument_type: GOOGLE_PAY | |
bin: '411111' | |
brand: VISA | |
card_type: UNKNOWN | |
expiration_month: 12 | |
expiration_year: 2027 | |
issuer_country: UNKNOWN | |
last_four: '1111' | |
name: Finix Sandbox | |
tags: {} | |
type: GOOGLE_PAY | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIf8dyFFcEGBqPhaG22hPyYs' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIf8dyFFcEGBqPhaG22hPyYs/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIf8dyFFcEGBqPhaG22hPyYs/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIf8dyFFcEGBqPhaG22hPyYs/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUfzF5qdNkBCtdgcf3333n' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/ID78Fh8mcnnzukVzbdoyex5y' | |
Payment Instrument - Update a Card's Address: | |
value: | |
id: PIwWisLuZNwPBoLbCgQVTCoY | |
created_at: '2022-08-15T23:13:06.13Z' | |
updated_at: '2023-02-28T21:12:29.72Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: null | |
disabled_message: null | |
enabled: true | |
fingerprint: FPRmYp7ejhA3yDjSor4A5Ji2D | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: PAYMENT_CARD | |
address: | |
line1: 900 Metro Center Blv | |
line2: Suite 200 | |
city: Los Angeles | |
region: CA | |
postal_code: '94404' | |
country: USA | |
address_verification: UNKNOWN | |
bin: '400000' | |
brand: VISA | |
card_type: UNKNOWN | |
expiration_month: 12 | |
expiration_year: 2029 | |
issuer_country: UNKNOWN | |
last_four: '9979' | |
name: Amy White | |
security_code_verification: UNMATCHED | |
tags: | |
card_name: Business Card | |
custom_key: custome value | |
type: PAYMENT_CARD | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
updates: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/updates' | |
Payment Instrument - Disable a Payment Instrument: | |
value: | |
id: PIwbvcQGrEP33HShmYM7BR8o | |
created_at: '2023-02-28T19:05:56.24Z' | |
updated_at: '2023-02-28T21:16:18.80Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: USER_INITIATED | |
disabled_message: The card has been disabled by a user. | |
enabled: false | |
fingerprint: FPRd5moHxL3Ltuvk4cczxetCg | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: NOT_ATTEMPTED | |
bank_code: '123123123' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: null | |
tags: | |
card_name: Personal Card | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
Payment Instrument - Bank Account Validation Check: | |
value: | |
id: PIpU66orYpdrPSs91fqRJd66 | |
created_at: '2023-03-13T23:28:34.10Z' | |
updated_at: '2023-03-13T23:28:34.10Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: null | |
disabled_message: null | |
enabled: true | |
fingerprint: FPRd5moHxL3Ltuvk4cczxetCg | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: VALID | |
bank_code: '123123123' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: null | |
tags: {} | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIpU66orYpdrPSs91fqRJd66' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIpU66orYpdrPSs91fqRJd66/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIpU66orYpdrPSs91fqRJd66/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIpU66orYpdrPSs91fqRJd66/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
Payment Instrument - Update Payment Instrument Tags: | |
value: | |
id: PIwbvcQGrEP33HShmYM7BR8o | |
created_at: '2023-02-28T19:05:56.24Z' | |
updated_at: '2023-02-28T21:18:24.79Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: null | |
disabled_message: null | |
enabled: true | |
fingerprint: FPRd5moHxL3Ltuvk4cczxetCg | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: NOT_ATTEMPTED | |
bank_code: '123123123' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: null | |
tags: | |
card_name: Personal Card | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwbvcQGrEP33HShmYM7BR8o/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
PaymentInstrumentToken: | |
description: Token response object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PaymentInstrumentToken' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
PaymentInstrumentUpdatesList: | |
description: List of Update objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PaymentInstrumentUpdatesList' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
PaymentInstrumentsList: | |
description: List of Payment Instrument objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PaymentInstrumentsList' | |
examples: | |
List of Payment Instruments: | |
value: | |
_embedded: | |
payment_instruments: | |
- id: PI3AbkuRR1JbT5kPiGQCXvD9 | |
created_at: '2022-10-11T01:42:53.29Z' | |
updated_at: '2022-10-11T01:42:53.29Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRd5moHxL3Ltuvk4cczxetCg | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: NOT_ATTEMPTED | |
bank_code: '123123123' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: John | |
tags: | |
Bank Account: Company Account | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PI3AbkuRR1JbT5kPiGQCXvD9/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
- id: PIrb1DcGz1qjThotDJ5KURpv | |
created_at: '2022-10-06T20:23:38.74Z' | |
updated_at: '2022-10-06T20:23:38.74Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
enabled: true | |
fingerprint: FPRtvYkgcwLUdjq7B4AgxKfmr | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
instrument_type: BANK_ACCOUNT | |
account_type: SAVINGS | |
bank_account_validation_check: NOT_ATTEMPTED | |
bank_code: '666666666' | |
country: USA | |
masked_account_number: XXXXX3123 | |
name: test_python | |
tags: | |
bank_account: Test Python Account | |
type: BANK_ACCOUNT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIrb1DcGz1qjThotDJ5KURpv' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIrb1DcGz1qjThotDJ5KURpv/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIrb1DcGz1qjThotDJ5KURpv/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIrb1DcGz1qjThotDJ5KURpv/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments?offset=14660&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 14679 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Processor: | |
description: Single Processor object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Processor' | |
examples: | |
Application Processor: | |
value: | |
id: PR9DvbgX5uuhqyKuBBD6VmFi | |
created_at: '2022-04-29T18:29:23.07Z' | |
updated_at: '2022-04-29T18:29:22.97Z' | |
application: APdHjTsAPx81go7ekSMJqQdz | |
application_config: | |
key1: value-1 | |
key2: value-2 | |
can_debit_bank_account: true | |
allow_split_payouts: false | |
ach_immediate_destination_name: null | |
default_currencies: | |
- USD | |
ach_settlement_delay_days: null | |
default_level_two_level_three_data_enabled: false | |
template_countries_available: [] | |
alert_on_unknown_merchants: false | |
config: | |
key1: value-1 | |
key2: value-2 | |
canDebitBankAccount: true | |
default_merchant_profile: MPpWCidKDfKZARSJKCAW3kex | |
enabled: true | |
processor: DUMMY_V1 | |
system_config: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdHjTsAPx81go7ekSMJqQdz/processors/DUMMY_V1' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APdHjTsAPx81go7ekSMJqQdz' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ProcessorsList: | |
description: List of Processor objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ProcessorsList' | |
examples: | |
List of Application Processors: | |
value: | |
_embedded: | |
processors: | |
- id: PRmr3QooJNFuehWTjsJwkWp8 | |
created_at: '2022-09-19T01:27:07.86Z' | |
updated_at: '2022-09-19T01:27:07.65Z' | |
application: APmuwPBaW8pVcwb4vCTHQH32 | |
application_config: | |
can_debit_bank_account: true | |
enable_pin_debit: true | |
ach_settlement_delay_days: null | |
allow_custom_billing: false | |
allow_partial_auth: false | |
allow_split_payouts: false | |
allow_create_credentials: false | |
amex_acquired: false | |
merchant_fraud_enabled: false | |
allow_debit_online: false | |
boarding_id: VGPG | |
business_type: Retail | |
vantiv_sftp_username: VGPGSFTP | |
vantiv_sftp_password: ca7Abrug | |
vantiv_chain_number: 0X6600 | |
vantiv_license: VANTIV license="6ad47..." | |
check_for_duplicate_transactions: 'Yes' | |
username: FINIXNEW | |
password: cert1234 | |
chargebacks_username: null | |
chargebacks_password: null | |
payfac_merchant_id: '01185553' | |
payfac_username: FINIXNEWMP | |
payfac_password: cert12mp | |
reports_sftp_username: username | |
reports_sftp_password: password | |
ach_immediate_destination_name: null | |
sftp_username: finixv12txn | |
sftp_password: 4J7Lp9Xq | |
tp_application_name: express.chris | |
tp_application_id: null | |
tp_application_version: '1.0' | |
tp_authorization: Version=2.0 | |
tp_base_url: 'https://triposcert.vantiv.com/' | |
ep_transaction_url: null | |
ep_reporting_url: null | |
ep_services_url: null | |
ep_application_id: null | |
ep_application_name: null | |
ep_application_version: null | |
settlement_payment_type: regular | |
card_sale_submission_method: null | |
default_currencies: | |
- USD | |
vantiv_trace_id_option: null | |
acquiring_bin: null | |
default_level_two_level_three_data_enabled: false | |
template_countries_available: [] | |
alert_on_unknown_merchants: false | |
config: | |
key1: value-1 | |
key2: value-2 | |
canDebitBankAccount: true | |
default_merchant_profile: MP53dza14XzW4VYqRTnQ8Bpw | |
enabled: true | |
processor: VANTIV_V1 | |
system_config: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32/processors/VANTIV_V1' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32' | |
- id: PRrH5Cy9ZYFUZDha4cuDgipv | |
created_at: '2022-04-01T20:45:28.22Z' | |
updated_at: '2022-04-01T20:45:28.11Z' | |
application: APmuwPBaW8pVcwb4vCTHQH32 | |
application_config: | |
default_sender_account_number: '1415888508012' | |
default_sender_address_line1: 21 Broadway | |
default_sender_address_line2: null | |
default_sender_city: OFallon | |
default_sender_country: CRI | |
default_sender_country_code: CRI | |
default_sender_postal_code: '63368' | |
default_sender_first_name: Michael | |
default_sender_last_name: Serna | |
default_sender_full_name: Michael Serna | |
sanction_screening_override: true | |
card_acceptor_id: null | |
statement_descriptor: null | |
default_payment_type: P2P | |
default_currencies: | |
- CRC | |
configuration_templates: null | |
ach_settlement_delay_days: null | |
default_level_two_level_three_data_enabled: false | |
allow_split_payouts: false | |
alert_on_unknown_merchants: false | |
config: {} | |
default_merchant_profile: MP53dza14XzW4VYqRTnQ8Bpw | |
enabled: true | |
processor: MASTERCARD_V1 | |
system_config: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32/processors/MASTERCARD_V1' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32' | |
- id: PR686aPfkq2cyHGtKfsxtoib | |
created_at: '2021-10-04T17:46:10.09Z' | |
updated_at: '2021-10-04T17:46:10.00Z' | |
application: APmuwPBaW8pVcwb4vCTHQH32 | |
application_config: | |
key1: value-1 | |
key2: value-2 | |
can_debit_bank_account: true | |
allow_split_payouts: false | |
ach_immediate_destination_name: null | |
default_currencies: | |
- USD | |
ach_settlement_delay_days: null | |
default_level_two_level_three_data_enabled: false | |
template_countries_available: [] | |
alert_on_unknown_merchants: false | |
config: | |
key1: value-1 | |
key2: value-2 | |
canDebitBankAccount: true | |
default_merchant_profile: MPf31wi1tKdVqtrT8PFyPFSg | |
enabled: true | |
processor: DUMMY_V1 | |
system_config: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32/processors/DUMMY_V1' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/applications/APmuwPBaW8pVcwb4vCTHQH32/processors?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 3 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ReversalsList: | |
description: List of Reversals | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/TransfersList' | |
examples: | |
List of Reversals on a Transfer: | |
value: | |
_embedded: | |
transfers: | |
- id: TRtLhSEAHak7isKjZu9x7Gjh | |
created_at: '2022-10-10T04:16:27.47Z' | |
updated_at: '2022-10-10T04:17:05.03Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: PIe2YvpcjvoVJ6PzoRPBK137 | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-10-10T04:17:05.04Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: refund | |
trace_id: e200c5b9-3ac9-4a21-a69e-cd0ffb6c2490 | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtLhSEAHak7isKjZu9x7Gjh' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtLhSEAHak7isKjZu9x7Gjh/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
- id: TRrP7CFqBid1C8kYpBMbxz5q | |
created_at: '2022-09-09T12:32:07.42Z' | |
updated_at: '2022-09-09T12:32:16.39Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: PIe2YvpcjvoVJ6PzoRPBK137 | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-09-09T12:32:16.40Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: refund | |
trace_id: 40087e2c-b65d-4407-a5cc-3259b788f6ac | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrP7CFqBid1C8kYpBMbxz5q' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrP7CFqBid1C8kYpBMbxz5q/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP/reversals?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP/reversals?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP/reversals?offset=820&limit=20&sort=created_at,desc&sort=id,desc' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 827 | |
unreversed_amount: 580954 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Settlement: | |
description: '`Settlement` object.' | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Settlement' | |
examples: | |
Settlement: | |
value: | |
id: STvUfBLbCUsun2KFoTuxR2j1 | |
created_at: '2022-08-09T17:06:02.99Z' | |
updated_at: '2022-08-09T17:15:25.60Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
funds_flow: null | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
merchant_id: MUeDVrf2ahuKc9Eg5TeZugvs | |
net_amount: 2238357 | |
payment_type: null | |
processor: DUMMY_V1 | |
status: AWAITING_APPROVAL | |
tags: {} | |
total_amount: 2287662 | |
total_fee: 49305 | |
total_fees: 49305 | |
type: MERCHANT_REVENUE | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
funding_transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/funding_transfers' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers?type=fee' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers?type=reverse' | |
credits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers?type=credit' | |
debits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers?type=debit' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STvUfBLbCUsun2KFoTuxR2j1/transfers?type=dispute' | |
Close Settlements: | |
value: | |
id: STdjQCfwwra8QBVZQhrfqdUt | |
created_at: '2023-06-06T22:35:07.98Z' | |
updated_at: '2023-06-06T22:35:16.69Z' | |
application: AP8Hb3WvAFQ2DUdqKJYszMo5 | |
currency: USD | |
destination: null | |
funds_flow: null | |
identity: IDj6kvMbVaeSzxQK6g1eoKKo | |
merchant_id: MUuCjso38AtQoNgfDdmcZ8gx | |
net_amount: 131854 | |
payment_type: null | |
processor: DUMMY_V1 | |
status: AWAITING_APPROVAL | |
tags: {} | |
total_amount: 131854 | |
total_fee: 0 | |
total_fees: 0 | |
type: MERCHANT_REVENUE | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/AP8Hb3WvAFQ2DUdqKJYszMo5' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDj6kvMbVaeSzxQK6g1eoKKo' | |
funding_transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/funding_transfers' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers?type=fee' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers?type=reverse' | |
credits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers?type=credit' | |
debits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers?type=debit' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STdjQCfwwra8QBVZQhrfqdUt/transfers?type=dispute' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SettlementsList: | |
description: List of `Settlement` objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SettlementsList' | |
examples: | |
List of Settlements: | |
value: | |
_embedded: | |
settlements: | |
- id: ST7R7mHjHq3ywG4vGa9cYe9b | |
created_at: '2023-07-14T09:10:02.91Z' | |
updated_at: '2023-07-15T07:15:58.36Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
funds_flow: null | |
identity: IDvHGrfeVmB3i7uL78xjemNk | |
merchant_id: MU7cXuKj2xx41hhZZi6bZ13A | |
net_amount: 8329 | |
payment_type: null | |
processor: DUMMY_V1 | |
status: AWAITING_APPROVAL | |
tags: {} | |
total_amount: 9252 | |
total_fee: 923 | |
total_fees: 923 | |
type: MERCHANT_REVENUE | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDvHGrfeVmB3i7uL78xjemNk' | |
funding_transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/funding_transfers' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers?type=fee' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers?type=reverse' | |
credits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers?type=credit' | |
debits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers?type=debit' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/settlements/ST7R7mHjHq3ywG4vGa9cYe9b/transfers?type=dispute' | |
- id: SThN7W7iDZM4mhGXqPDaVojn | |
created_at: '2022-12-21T22:05:08.10Z' | |
updated_at: '2022-12-22T07:15:56.22Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
funds_flow: null | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
merchant_id: MUeDVrf2ahuKc9Eg5TeZugvs | |
net_amount: 648211 | |
payment_type: null | |
processor: DUMMY_V1 | |
status: AWAITING_APPROVAL | |
tags: {} | |
total_amount: 661854 | |
total_fee: 13643 | |
total_fees: 13643 | |
type: MERCHANT_REVENUE | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
funding_transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/funding_transfers' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers?type=fee' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers?type=reverse' | |
credits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers?type=credit' | |
debits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers?type=debit' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/settlements/SThN7W7iDZM4mhGXqPDaVojn/transfers?type=dispute' | |
- id: STsdvwKDyZq3gwZi5upuAETj | |
created_at: '2022-12-21T22:00:06.57Z' | |
updated_at: '2022-12-22T07:15:55.04Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
funds_flow: null | |
identity: IDvHGrfeVmB3i7uL78xjemNk | |
merchant_id: MU7cXuKj2xx41hhZZi6bZ13A | |
net_amount: 648811 | |
payment_type: null | |
processor: DUMMY_V1 | |
status: AWAITING_APPROVAL | |
tags: {} | |
total_amount: 662154 | |
total_fee: 13343 | |
total_fees: 13343 | |
type: MERCHANT_REVENUE | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDvHGrfeVmB3i7uL78xjemNk' | |
funding_transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/funding_transfers' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers?type=fee' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers?type=reverse' | |
credits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers?type=credit' | |
debits: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers?type=debit' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STsdvwKDyZq3gwZi5upuAETj/transfers?type=dispute' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/settlements/?after_cursor=STsdvwKDyZq3gwZi5upuAETj' | |
page: | |
limit: 100 | |
next_cursor: STsdvwKDyZq3gwZi5upuAETj | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Transfer: | |
description: Single Transfer object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Transfer' | |
examples: | |
Transfer: | |
value: | |
id: TRhw2BGAqyFZcrjTYXq4qTvY | |
created_at: '2022-10-10T03:49:20.71Z' | |
updated_at: '2022-10-10T03:49:21.62Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 662154 | |
amount_requested: 662154 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: 9789aa49-23a5-47c5-9ca1-7492a582fcde | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhw2BGAqyFZcrjTYXq4qTvY' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhw2BGAqyFZcrjTYXq4qTvY/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhw2BGAqyFZcrjTYXq4qTvY/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhw2BGAqyFZcrjTYXq4qTvY/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhw2BGAqyFZcrjTYXq4qTvY/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - 3D Secure: | |
value: | |
id: TR7QJuf7mD6vSAmwHYbhVWem | |
created_at: '2022-10-10T03:47:09.23Z' | |
updated_at: '2022-10-10T03:47:10.06Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 92169 | |
amount_requested: 92169 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: 9d8052e9-2432-4117-aa57-d5ff0a7acecc | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7QJuf7mD6vSAmwHYbhVWem' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7QJuf7mD6vSAmwHYbhVWem/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7QJuf7mD6vSAmwHYbhVWem/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7QJuf7mD6vSAmwHYbhVWem/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7QJuf7mD6vSAmwHYbhVWem/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Card Verification Checks: | |
value: | |
id: TR61nQ89c8U5i7uAvwmSuLnv | |
created_at: '2022-10-11T03:24:04.67Z' | |
updated_at: '2022-10-11T03:24:05.47Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 662154 | |
amount_requested: 662154 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: {} | |
trace_id: cc2e9d44-c87d-4cb2-bb2f-b7be2eea9afa | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Buyer Charges: | |
value: | |
id: TR499L4F49MmgTxQTP8XNwrZ | |
created_at: '2023-12-06T17:51:35.95Z' | |
updated_at: '2023-12-06T17:51:36.98Z' | |
additional_buyer_charges: | |
convenience_amount: 150 | |
surcharge_amount: 0 | |
rent_surcharge_amount: 0 | |
additional_healthcare_data: null | |
additional_purchase_data: null | |
address_verification: null | |
amount: 5200 | |
amount_requested: 5200 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
parent_transfer: null | |
parent_transfer_trace_id: null | |
raw: null | |
ready_to_settle_at: null | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: [] | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: 1eaaa84e-0bb2-4565-b882-33976b0ac19d | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR499L4F49MmgTxQTP8XNwrZ' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR499L4F49MmgTxQTP8XNwrZ/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR499L4F49MmgTxQTP8XNwrZ/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR499L4F49MmgTxQTP8XNwrZ/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR499L4F49MmgTxQTP8XNwrZ/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Debit Bank Account: | |
value: | |
id: TRrfaQBfXkc4wopWK6pcrnoR | |
created_at: '2022-10-10T03:51:19.27Z' | |
updated_at: '2022-10-10T03:51:20.77Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 6031 | |
amount_requested: 6031 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 603 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIr1Ru7ewBkEYVVn7SP1u5FW | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: e7f2e240-f6e5-41ef-a533-ed6c8ccf5222 | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrfaQBfXkc4wopWK6pcrnoR' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrfaQBfXkc4wopWK6pcrnoR/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrfaQBfXkc4wopWK6pcrnoR/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrfaQBfXkc4wopWK6pcrnoR/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrfaQBfXkc4wopWK6pcrnoR/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIr1Ru7ewBkEYVVn7SP1u5FW' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - HSA or FSA Cards: | |
value: | |
id: TR8bRJ22SBReMehVQMVAbRpr | |
created_at: '2022-10-10T06:31:52.37Z' | |
updated_at: '2022-10-10T06:31:53.12Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 950 | |
amount_requested: 950 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: ea7c2b3e-bef7-45c5-aac3-76c94e25cb65 | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Level 2 Processing: | |
value: | |
id: TRfnDYRPA5cNN5nup9WWpavy | |
created_at: '2022-10-10T03:27:23.09Z' | |
updated_at: '2022-10-10T03:27:23.74Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: 8356c796-90ea-43ed-9dba-7a31dd5d1a1c | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRfnDYRPA5cNN5nup9WWpavy' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRfnDYRPA5cNN5nup9WWpavy/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRfnDYRPA5cNN5nup9WWpavy/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRfnDYRPA5cNN5nup9WWpavy/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRfnDYRPA5cNN5nup9WWpavy/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Level 3 Processing: | |
value: | |
id: TRhNEVxYWDF97SEqBJHykPDH | |
created_at: '2022-10-10T03:42:15.11Z' | |
updated_at: '2022-10-10T03:42:15.68Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: ce93f81e-187d-4d2a-b387-bb316f9efa9a | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhNEVxYWDF97SEqBJHykPDH' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhNEVxYWDF97SEqBJHykPDH/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhNEVxYWDF97SEqBJHykPDH/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhNEVxYWDF97SEqBJHykPDH/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhNEVxYWDF97SEqBJHykPDH/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Partial Authorization: | |
value: | |
id: TRbBacinCABghkSScrwXPR5A | |
created_at: '2023-10-12T21:21:40.97Z' | |
updated_at: '2023-10-12T21:21:42.38Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
additional_purchase_data: null | |
address_verification: null | |
amount: 662154 | |
amount_requested: 662154 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
parent_transfer: null | |
parent_transfer_trace_id: null | |
raw: null | |
ready_to_settle_at: null | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: [] | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: 96fa40ab-80c7-4f6b-8912-ce062e13b429 | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRbBacinCABghkSScrwXPR5A' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRbBacinCABghkSScrwXPR5A/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRbBacinCABghkSScrwXPR5A/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRbBacinCABghkSScrwXPR5A/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRbBacinCABghkSScrwXPR5A/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Transfer - Split Transaction: | |
value: | |
id: TRmCUZEnXF3BAr4uUKG5YVcW | |
created_at: '2023-07-25T23:33:26.16Z' | |
updated_at: '2023-07-25T23:33:27.99Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
split_transfers: | |
- split_transfer_mDDBJcdfbvZQD5KbfdnECV | |
- split_transfer_mDEEvWVsk3b963EhZha52k | |
- split_transfer_mDEEXLvLihTL24iGdLWwbb | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: sale | |
trace_id: db85490a-7fbe-4e10-9edd-13e39f930ddf | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmCUZEnXF3BAr4uUKG5YVcW' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmCUZEnXF3BAr4uUKG5YVcW/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmCUZEnXF3BAr4uUKG5YVcW/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmCUZEnXF3BAr4uUKG5YVcW/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmCUZEnXF3BAr4uUKG5YVcW/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Card Present Transfer - EMV Card: | |
value: | |
id: TRtC5R4pnKkLj8hcLpgFivoS | |
created_at: '2022-10-10T06:07:52.01Z' | |
updated_at: '2022-10-10T06:07:53.01Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 150 | |
amount_requested: 150 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: null | |
masked_account_number: null | |
name: null | |
brand: null | |
entry_mode: null | |
payment_type: NONE | |
approval_code: null | |
currency: USD | |
destination: null | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: null | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PI64EnboFzoZNFkBUHbgVDa2 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FIN*GOLDS GYM | |
subtype: API | |
tags: | |
order_number: chris123transfer | |
trace_id: FNXsK76MxJWPkbGqpKymgkzK | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtC5R4pnKkLj8hcLpgFivoS' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtC5R4pnKkLj8hcLpgFivoS/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtC5R4pnKkLj8hcLpgFivoS/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtC5R4pnKkLj8hcLpgFivoS/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRtC5R4pnKkLj8hcLpgFivoS/disputes' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPrATYzpomaTRtdo2BssRoGx' | |
Card Present Transfer - Non-EMV Card: | |
value: | |
id: TRhzZurepF7DwpL3REV5jU2T | |
created_at: '2022-10-10T06:12:31.55Z' | |
updated_at: '2022-10-10T06:12:33.09Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 150 | |
amount_requested: 150 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: null | |
masked_account_number: null | |
name: null | |
brand: null | |
entry_mode: null | |
payment_type: NONE | |
approval_code: null | |
currency: USD | |
destination: null | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: null | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PI6SBgTQipPQa3ZpDe27Fbym | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FIN*GOLDS GYM | |
subtype: API | |
tags: | |
order_number: chris123transfer | |
trace_id: FNXkc963gjMZh8eLfgSHWmgHz | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhzZurepF7DwpL3REV5jU2T' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhzZurepF7DwpL3REV5jU2T/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhzZurepF7DwpL3REV5jU2T/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhzZurepF7DwpL3REV5jU2T/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhzZurepF7DwpL3REV5jU2T/disputes' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPrATYzpomaTRtdo2BssRoGx' | |
Card Present Transfer - Manual Entry: | |
value: | |
id: TRi5vEeiCojkBCnvq8AD3HGm | |
created_at: '2022-10-10T03:20:50.29Z' | |
updated_at: '2022-10-10T03:20:51.71Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 150 | |
amount_requested: 150 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: null | |
masked_account_number: null | |
name: null | |
brand: null | |
entry_mode: null | |
payment_type: NONE | |
approval_code: null | |
currency: USD | |
destination: null | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: null | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PI9D3HHedxWzCaadkGqrX2t1 | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FIN*GOLDS GYM | |
subtype: API | |
tags: | |
order_number: chris123transfer | |
trace_id: FNXbAn8pqY7Pb2238uTFcdAiN | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRi5vEeiCojkBCnvq8AD3HGm' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRi5vEeiCojkBCnvq8AD3HGm/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRi5vEeiCojkBCnvq8AD3HGm/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRi5vEeiCojkBCnvq8AD3HGm/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRi5vEeiCojkBCnvq8AD3HGm/disputes' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPrATYzpomaTRtdo2BssRoGx' | |
Refund Transfer: | |
value: | |
id: TRhLCS57STJRfpw2ZoRhSHf2 | |
created_at: '2023-09-19T20:19:58.95Z' | |
updated_at: '2023-09-19T20:19:59.01Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
additional_purchase_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: PIe2YvpcjvoVJ6PzoRPBK137 | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
parent_transfer: TRr3Rd7Sy7zbrsWAH7Jwo7vt | |
parent_transfer_trace_id: null | |
raw: null | |
ready_to_settle_at: null | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: [] | |
state: PENDING | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: refund | |
trace_id: 4ec8b76b-c615-455d-ba78-c03f0f480b4a | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhLCS57STJRfpw2ZoRhSHf2' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRr3Rd7Sy7zbrsWAH7Jwo7vt' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRhLCS57STJRfpw2ZoRhSHf2/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Refund Transfer - Card Present: | |
value: | |
id: TRpc9StVytskqYnWoF2Ho8pK | |
created_at: '2022-10-10T03:17:34.57Z' | |
updated_at: '2022-10-10T03:17:35.83Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 150 | |
amount_requested: 150 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: | |
emv_data: null | |
masked_account_number: null | |
name: null | |
brand: null | |
entry_mode: null | |
payment_type: NONE | |
approval_code: null | |
currency: USD | |
destination: PInUwPXf1MYj7xJ8jfmdksa5 | |
device: DVtk6E4eWHsMzgZXvFaaUigM | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: null | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FIN*GOLDS GYM | |
subtype: API | |
tags: {} | |
trace_id: FNXkYuDrPQxzpNk5xtGhXSyU8 | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRpc9StVytskqYnWoF2Ho8pK' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRn9pzzn1NVLdwwBwVrqSwAX' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PInUwPXf1MYj7xJ8jfmdksa5' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRpc9StVytskqYnWoF2Ho8pK/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPrATYzpomaTRtdo2BssRoGx' | |
Refund Transfer - Split Transaction: | |
value: | |
id: TRm23kdc4SCxYyva47RyiZv | |
created_at: '2023-07-19T03:02:02.89Z' | |
updated_at: '2023-07-19T03:02:03.01Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 1000 | |
amount_requested: 1000 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: PIe2YvpcjvoVJ6PzoRPBK137 | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: | |
- split_transfer_m7Y8kgx4nunsrVbuMdedDo | |
- split_transfer_m7Yct9DmD5ctdWxDTAZjPc | |
- split_transfer_m7YcD9mGG92oqxPPDhE23U | |
state: PENDING | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: | |
test: refund | |
trace_id: d1c14ed9-1945-4cef-b0f8-c1d8ba037a86 | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm23kdc4SCxYyva47RyiZv' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR7h8NxhCDHunLFdJ1HCLp4r' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm23kdc4SCxYyva47RyiZv/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
Refund Transfer - Swiped Card: | |
value: | |
id: TR3vLiG6wecEwY3TC3oQiudG | |
created_at: '2019-04-24T19:19:34.11Z' | |
updated_at: '2019-04-24T19:19:48.09Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APuZMfMerci2JuLUs7xWpf5G | |
card_present_details: | |
emv_data: null | |
masked_account_number: '************0006' | |
name: TEST/WORLDPAY | |
brand: VISA | |
entry_mode: SWIPED | |
payment_type: CREDIT | |
approval_code: '000019' | |
currency: USD | |
destination: PIiPybsvUSM4fN8sYaMS3qXg | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: null | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: FNXQA*FINIX FLOWERS | |
subtype: API | |
tags: | |
order_number: testing123 | |
trace_id: FNXgm7zyjYEmYwUQ3fktSTkaZ | |
type: REVERSAL | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/payment_instruments' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/disputes' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIiPybsvUSM4fN8sYaMS3qXg' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
TransfersList: | |
description: List of Transfer objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/TransfersList' | |
examples: | |
List of Transfers: | |
value: | |
_embedded: | |
transfers: | |
- id: TRvQN3v5mhA2Ttc78hzjLV3j | |
created_at: '2022-10-11T03:25:04.79Z' | |
updated_at: '2022-10-11T03:25:04.79Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 13243 | |
amount_requested: 13243 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_BASIS_POINTS | |
idempotency_id: null | |
merchant_identity: IDddHpRqwf2VsH2XB1fmLfhM | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-10-11T03:25:05.32Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: 611dcc5f-0622-4ec7-8c8b-b08896456d62 | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRvQN3v5mhA2Ttc78hzjLV3j' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDddHpRqwf2VsH2XB1fmLfhM' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRvQN3v5mhA2Ttc78hzjLV3j/payment_instruments' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR61nQ89c8U5i7uAvwmSuLnv' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
- id: TR34MdY6eagpEqhtTaP8EBCR | |
created_at: '2022-10-10T06:32:04.58Z' | |
updated_at: '2022-10-10T06:32:04.58Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 19 | |
amount_requested: 19 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_BASIS_POINTS | |
idempotency_id: null | |
merchant_identity: IDddHpRqwf2VsH2XB1fmLfhM | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-10-10T06:32:05.05Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: a79105c7-8b93-4c36-8734-83f02ca0686c | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR34MdY6eagpEqhtTaP8EBCR' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDddHpRqwf2VsH2XB1fmLfhM' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR34MdY6eagpEqhtTaP8EBCR/payment_instruments' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8bRJ22SBReMehVQMVAbRpr' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/transfers?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/transfers?offset=23980&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
limit: 100 | |
next_cursor: TRvynw5NU1Uo6TB5USyhbzCx | |
List of Settlement Funding Transfers: | |
value: | |
_embedded: | |
transfers: | |
- id: TRkwxPhCf3qChKFEVGhDjr76 | |
created_at: '2022-08-12T21:46:12.97Z' | |
updated_at: '2022-08-12T21:47:06.65Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 102 | |
amount_requested: 102 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: PIrFpayBAQcqK35HMQgRfaqD | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: null | |
state: FAILED | |
statement_descriptor: null | |
subtype: SETTLEMENT_PLATFORM | |
tags: {} | |
trace_id: d4a6df17-f581-42d0-ac70-ad6770acd5c4 | |
type: CREDIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkwxPhCf3qChKFEVGhDjr76' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkwxPhCf3qChKFEVGhDjr76/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkwxPhCf3qChKFEVGhDjr76/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkwxPhCf3qChKFEVGhDjr76/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRkwxPhCf3qChKFEVGhDjr76/disputes' | |
destination: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIrFpayBAQcqK35HMQgRfaqD' | |
- id: TRxb61dJ6PvGcvyS2L2B9SZE | |
created_at: '2022-08-12T21:46:12.98Z' | |
updated_at: '2022-08-12T21:47:05.26Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 2 | |
amount_requested: 2 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: UNKNOWN | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: null | |
security_code_verification: null | |
source: PIm8mdyYcEnYAZLLyw8g59Pw | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: SETTLEMENT_MERCHANT | |
tags: {} | |
trace_id: e192bc39-0909-4da9-b4c2-022a84ae3984 | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRxb61dJ6PvGcvyS2L2B9SZE' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRxb61dJ6PvGcvyS2L2B9SZE/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRxb61dJ6PvGcvyS2L2B9SZE/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRxb61dJ6PvGcvyS2L2B9SZE/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRxb61dJ6PvGcvyS2L2B9SZE/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIm8mdyYcEnYAZLLyw8g59Pw' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STivxR2KrnVdD75TQtitnsG8/funding_transfers?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
limit: 100 | |
next_cursor: TRvynw5NU1Uo6TB5USyhbzCx | |
List of Settlement Transfers: | |
value: | |
_embedded: | |
transfers: | |
- id: TR8yiKY6ju988aUZhfqJFjag | |
created_at: '2022-08-12T16:56:01.90Z' | |
updated_at: '2022-08-12T16:56:01.90Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_FIXED | |
idempotency_id: null | |
merchant_identity: IDddHpRqwf2VsH2XB1fmLfhM | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-08-12T22:15:02.69Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: 272fe816-2dd1-46ed-a7e7-9041d7a8f0ff | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8yiKY6ju988aUZhfqJFjag' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDddHpRqwf2VsH2XB1fmLfhM' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR8yiKY6ju988aUZhfqJFjag/payment_instruments' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
- id: TRm9ppvqX43CbwmNzhckf2gb | |
created_at: '2022-08-12T16:55:47.66Z' | |
updated_at: '2022-08-12T16:56:02.19Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-08-12T04:00:00.00Z' | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
statement_descriptor: FNX*DUNDER MIFFLIN | |
subtype: API | |
tags: {} | |
trace_id: 381f1f6f-492b-4101-9a57-40001a59813a | |
type: DEBIT | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb/payment_instruments' | |
reversals: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb/reversals' | |
fees: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb/fees' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb/disputes' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
- id: TRwgubpxAJWbaDZE1kKP6SSi | |
created_at: '2022-08-12T16:56:01.90Z' | |
updated_at: '2022-08-12T16:56:01.90Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 2 | |
amount_requested: 2 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_BASIS_POINTS | |
idempotency_id: null | |
merchant_identity: IDddHpRqwf2VsH2XB1fmLfhM | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-08-12T22:15:02.69Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: 5e2dbd9c-1ad1-4e36-8d16-cfedd3bce385 | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRwgubpxAJWbaDZE1kKP6SSi' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDddHpRqwf2VsH2XB1fmLfhM' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRwgubpxAJWbaDZE1kKP6SSi/payment_instruments' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRm9ppvqX43CbwmNzhckf2gb' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/settlements/STivxR2KrnVdD75TQtitnsG8/transfers?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
limit: 100 | |
next_cursor: TRvynw5NU1Uo6TB5USyhbzCx | |
List of Split Transfer Fees: | |
value: | |
_embedded: | |
transfers: | |
- id: TRf75ZVCM1M4eVojmVYGUnuQ | |
created_at: '2023-07-19T02:30:17.43Z' | |
updated_at: '2023-07-19T02:30:17.43Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 30 | |
amount_requested: 30 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_FIXED | |
idempotency_id: null | |
merchant: MU4jpoNGRkAyjBxumZhGa6Hc | |
merchant_identity: IDhCtMvcteDx37eD9m4rmdKd | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2023-07-19T07:30:01.27Z' | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: 2c56f4f0-1f48-451c-9498-199daaff2e39 | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRf75ZVCM1M4eVojmVYGUnuQ' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDhCtMvcteDx37eD9m4rmdKd' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRf75ZVCM1M4eVojmVYGUnuQ/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPbDSnEPtaT8Nttxj9NJk7eC' | |
- id: TR4AyjeiKwML2rZ6fWyVaQST | |
created_at: '2023-07-19T02:30:17.43Z' | |
updated_at: '2023-07-19T02:30:17.43Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 17 | |
amount_requested: 17 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
fee_type: CARD_BASIS_POINTS | |
idempotency_id: null | |
merchant: MU4jpoNGRkAyjBxumZhGa6Hc | |
merchant_identity: IDhCtMvcteDx37eD9m4rmdKd | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2023-07-19T07:30:01.27Z' | |
receipt_last_printed_at: null | |
security_code_verification: null | |
source: null | |
split_transfers: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_FEE | |
tags: {} | |
trace_id: 48a6fa39-5639-4e2c-b316-fad2db170954 | |
type: FEE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR4AyjeiKwML2rZ6fWyVaQST' | |
parent: | |
href: 'https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDhCtMvcteDx37eD9m4rmdKd' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TR4AyjeiKwML2rZ6fWyVaQST/payment_instruments' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPbDSnEPtaT8Nttxj9NJk7eC' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q/fees' | |
page: | |
limit: 100 | |
next_cursor: TR4AyjeiKwML2rZ6fWyVaQST | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
User: | |
description: Single `User` object. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/User' | |
examples: | |
ROLE_PARTNER User: | |
value: | |
id: USvVu9MXHz7hVzwDXwbx3UCL | |
created_at: '2022-01-27T07:37:14.65Z' | |
updated_at: '2022-01-27T07:37:15.47Z' | |
enabled: true | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
password: null | |
role: ROLE_MERCHANT | |
tags: | |
card_name: New Employee | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/users/USvVu9MXHz7hVzwDXwbx3UCL' | |
applications: | |
href: 'https://finix.sandbox-payments-api.com/applications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
UsersList: | |
description: List of `User` objects. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/UsersList' | |
examples: | |
List of Users: | |
value: | |
_embedded: | |
users: | |
- id: USsRhsHYZGBPnQw8CByJyEQW | |
created_at: '2022-01-27T07:36:32.91Z' | |
updated_at: '2022-01-27T07:36:33.78Z' | |
enabled: true | |
identity: IDuquemzE7UkUJioGJfVKBKt | |
password: null | |
role: ROLE_PARTNER | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/users/USsRhsHYZGBPnQw8CByJyEQW' | |
applications: | |
href: 'https://finix.sandbox-payments-api.com/applications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
- id: USjDY98nG9tn5n271vwNcNc9 | |
created_at: '2022-10-11T04:45:54.56Z' | |
updated_at: '2022-10-11T04:45:54.56Z' | |
enabled: true | |
identity: IDuquemzE7UkUJioGJfVKBKt | |
password: null | |
role: ROLE_PARTNER | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/users/USjDY98nG9tn5n271vwNcNc9' | |
applications: | |
href: 'https://finix.sandbox-payments-api.com/applications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/users?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 8 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Verification: | |
description: Single Verification object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Verification' | |
examples: | |
Payment Instrument - Verify a Card’s CVV: | |
value: | |
id: PIwWisLuZNwPBoLbCgQVTCoY | |
created_at: '2022-08-15T23:13:06.13Z' | |
updated_at: '2023-10-05T14:50:31.58Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: null | |
disabled_message: null | |
enabled: true | |
fingerprint: FPRmYp7ejhA3yDjSor4A5Ji2D | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: PAYMENT_CARD | |
address: | |
line1: 900 Metro Center Blv | |
line2: null | |
city: San Francisco | |
region: CA | |
postal_code: '94404' | |
country: CHN | |
address_verification: NO_MATCH | |
bin: '400000' | |
brand: VISA | |
card_type: UNKNOWN | |
expiration_month: 12 | |
expiration_year: 2029 | |
issuer_country: UNKNOWN | |
last_four: '9979' | |
name: Amy White | |
security_code_verification: UNMATCHED | |
tags: | |
card_name: Business_Card | |
quote: qu`te | |
qu`ote: qu`te | |
custom_key: custome value | |
type: PAYMENT_CARD | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
updates: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/updates' | |
Payment Instrument - Verify a Card’s Address: | |
value: | |
id: PIwWisLuZNwPBoLbCgQVTCoY | |
created_at: '2022-08-15T23:13:06.13Z' | |
updated_at: '2023-10-17T23:10:09.93Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
created_via: API | |
currency: USD | |
disabled_code: null | |
disabled_message: null | |
enabled: true | |
fingerprint: FPRmYp7ejhA3yDjSor4A5Ji2D | |
identity: IDgWxBhfGYLLdkhxx2ddYf9K | |
instrument_type: PAYMENT_CARD | |
address: | |
line1: 900 Metro Center Blv | |
line2: null | |
city: San Francisco | |
region: CA | |
postal_code: '94404' | |
country: USA | |
address_verification: UNKNOWN | |
bin: '400000' | |
brand: VISA | |
card_type: UNKNOWN | |
expiration_month: 12 | |
expiration_year: 2029 | |
issuer_country: UNKNOWN | |
last_four: '9979' | |
name: Amy White | |
security_code_verification: UNMATCHED | |
tags: | |
card_name: Business_Card | |
quote: qu`te | |
qu`ote: qu`te | |
custom_key: custome value | |
type: PAYMENT_CARD | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/transfers' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/verifications' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDgWxBhfGYLLdkhxx2ddYf9K' | |
updates: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY/updates' | |
Payment Instrument - Verify Push-to-Card Eligibility: | |
value: | |
id: VI4HPBpdRHQLR88MY3AjS366 | |
created_at: '2023-10-31T19:00:33.66Z' | |
updated_at: '2023-10-31T19:00:35.25Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
identity: null | |
merchant: null | |
merchant_identity: null | |
messages: [] | |
payment_instrument: PIwWisLuZNwPBoLbCgQVTCoY | |
payment_instrument_verification_details: | |
push_to_card_domestic: FAST_FUNDS | |
push_to_card_cross_border: FAST_FUNDS | |
card_type: DEBIT | |
billing_currency: USD | |
issuer_country: USA | |
processor: VISA_V1 | |
raw: | |
validation_details: | |
systems_trace_audit_number: '330419210605' | |
error_result: null | |
transaction_identifier: '583304684345495' | |
approval_code: '226664' | |
action_code: '00' | |
response_code: V | |
address_verification_results: U | |
cvv2_result_code: M | |
inquiry_details: | |
systems_trace_audit_number: '330419210605' | |
error_result: null | |
visa_network_info: | |
- card_type_code: D | |
billing_currency_code: 320 | |
billing_currency_minor_digits: 2 | |
issuer_name: VISA TEST BANK S.A. | |
card_issuer_country_code: 320 | |
fast_funds_indicator: B | |
push_funds_block_indicator: C | |
online_gambing_block_indicator: 'Y' | |
card_product_type: D | |
billing_currency: 320 | |
billing_currency_code_minor_digits: 2 | |
non_money_transfer_push_funds_domestic: 'Y' | |
non_money_transfer_push_funds_cross_border: 'Y' | |
online_gambling_push_funds_domestic: 'Y' | |
online_gambling_push_funds_cross_border: 'Y' | |
money_transfer_push_funds_domestic: 'Y' | |
money_transfer_push_funds_cross_border: 'Y' | |
non_money_transfer_fast_funds_domestic: 'Y' | |
non_money_transfer_fast_funds_cross_border: 'Y' | |
online_gambling_fast_funds_domestic: 'Y' | |
online_gambling_fast_funds_cross_border: 'Y' | |
money_transfer_fast_funds_domestic: 'Y' | |
money_transfer_fast_funds_cross_border: 'Y' | |
combo_card_range: '0' | |
card_platform_code: CN | |
issuer_country_code: 320 | |
ppgs_network_info: [] | |
state: SUCCEEDED | |
tags: {} | |
trace_id: '330419210605' | |
type: PAYMENT_INSTRUMENT | |
_links: | |
self: | |
href: 'https://finix.live-payments-api.com/verifications/VI4HPBpdRHQLR88MY3AjS366' | |
application: | |
href: 'https://finix.live-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
payment_instrument: | |
href: 'https://finix.live-payments-api.com/payment_instruments/PIwWisLuZNwPBoLbCgQVTCoY' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
VerificationsList: | |
description: List of Verification objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/VerificationsList' | |
examples: | |
Merchant Verification: | |
value: | |
_embedded: | |
verifications: | |
- id: VInHzhoRAnAizVU7jcj2K6bX | |
created_at: '2022-08-15T23:12:56.40Z' | |
updated_at: '2022-08-15T23:12:56.85Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
identity: null | |
merchant: MUpaGK5dUb2Sb7aGuXhFRNbj | |
merchant_identity: IDgahPGJ6hangmVJwrMRyZzr | |
messages: [] | |
payment_instrument: null | |
processor: DUMMY_V1 | |
raw: RawDummyMerchantUnderwriteResult | |
state: SUCCEEDED | |
tags: {} | |
trace_id: 1c8fb49d-6f1c-40a0-8646-1bcb88047583 | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VInHzhoRAnAizVU7jcj2K6bX' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUpaGK5dUb2Sb7aGuXhFRNbj' | |
- id: VIdS8qSW3kZbnK9AsFHJZ81U | |
created_at: '2022-08-15T23:12:54.32Z' | |
updated_at: '2022-08-15T23:12:54.65Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
identity: null | |
merchant: MUpaGK5dUb2Sb7aGuXhFRNbj | |
merchant_identity: IDgahPGJ6hangmVJwrMRyZzr | |
messages: [] | |
payment_instrument: null | |
processor: DUMMY_V1 | |
raw: RawDummyMerchantUnderwriteResult | |
state: SUCCEEDED | |
tags: | |
key: value_2 | |
trace_id: 4d12cbe6-032d-4e9d-8291-ce16f4add412 | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIdS8qSW3kZbnK9AsFHJZ81U' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUpaGK5dUb2Sb7aGuXhFRNbj' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUpaGK5dUb2Sb7aGuXhFRNbj/verifications?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 2 | |
Payment Instrument Verification: | |
value: | |
_embedded: | |
verifications: | |
- id: VIixxYGRVewLFa3GqSzqKPbw | |
created_at: '2022-02-04T18:33:14.50Z' | |
updated_at: '2022-02-04T18:33:15.69Z' | |
application: AP83dL8NE1Q7KfQo9onGg76M | |
identity: null | |
merchant: null | |
merchant_identity: null | |
messages: [] | |
payment_instrument: PImc5nvdnp15atLxEBAGtxJs | |
processor: VISA_V1 | |
raw: | |
validation_details: | |
systems_trace_audit_number: '203518208518' | |
error_result: null | |
transaction_identifier: '287371129315250' | |
approval_code: null | |
action_code: '25' | |
response_code: '5' | |
address_verification_results: I | |
cvv2_result_code: P | |
inquiry_details: | |
systems_trace_audit_number: '203518208518' | |
error_result: null | |
visa_network_info: | |
- card_type_code: D | |
billing_currency_code: 840 | |
billing_currency_minor_digits: 2 | |
issuer_name: Visa Test Bank | |
card_issuer_country_code: 840 | |
fast_funds_indicator: D | |
push_funds_block_indicator: C | |
online_gambing_block_indicator: 'N' | |
ppgs_network_info: [] | |
state: SUCCEEDED | |
tags: {} | |
trace_id: '203518208518' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIixxYGRVewLFa3GqSzqKPbw' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/AP83dL8NE1Q7KfQo9onGg76M' | |
payment_instrument: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImc5nvdnp15atLxEBAGtxJs' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PImc5nvdnp15atLxEBAGtxJs/verifications/?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
Webhook: | |
description: Single Webhook object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Webhook' | |
examples: | |
Webhook: | |
value: | |
id: WHg3ocwoCz9PgF4ncZTyArFJ | |
created_at: '2022-10-10T03:56:10.15Z' | |
updated_at: '2022-10-10T03:56:10.15Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
authentication: | |
type: NONE | |
enabled: true | |
enabled_events: [] | |
previous_secret_expires_at: null | |
secret_signing_key: 3afb49c98ac08a67a58efa5580b24e5984bc36d7ebd404e875234f107deed108 | |
url: 'https://eohzjuj2prziycz.m.pipedream.net' | |
_links: | |
self: | |
href: 'http://finix.sandbox-payments-api.com/webhooks/WHg3ocwoCz9PgF4ncZTyArFJ' | |
application: | |
href: 'http://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
Filter Webhook Events: | |
value: | |
id: WHtPXJnAjmusyobzpmQZeHvJ | |
created_at: '2022-06-05T23:29:07.99Z' | |
updated_at: '2022-10-10T04:36:45.88Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
authentication: | |
type: NONE | |
enabled: false | |
enabled_events: | |
- entity: merchant | |
types: | |
- created | |
- underwritten | |
- entity: transfer | |
types: | |
- created | |
previous_secret_expires_at: null | |
url: 'https://eohzjuj2prziycz.m.pipedream.net' | |
_links: | |
self: | |
href: 'http://finix.sandbox-payments-api.com/webhooks/WHtPXJnAjmusyobzpmQZeHvJ' | |
application: | |
href: 'http://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
WebhooksList: | |
description: List of Webhook objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/WebhooksList' | |
examples: | |
List of Webhooks: | |
value: | |
_embedded: | |
webhooks: | |
- id: WHtbmULb3Y68oGfKWc9TLJnJ | |
created_at: '2022-09-27T18:40:29.20Z' | |
updated_at: '2022-09-27T18:40:29.39Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
authentication: | |
type: NONE | |
enabled: false | |
enabled_events: [] | |
previous_secret_expires_at: null | |
url: 'https://example.com/' | |
_links: | |
self: | |
href: 'http://finix.sandbox-payments-api.com/webhooks/WHtbmULb3Y68oGfKWc9TLJnJ' | |
application: | |
href: 'http://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
- id: WHmnVdiaimgD8aRTVvwuTZaj | |
created_at: '2022-09-27T18:38:56.81Z' | |
updated_at: '2022-09-27T18:38:57.03Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
authentication: | |
type: NONE | |
enabled: false | |
enabled_events: [] | |
previous_secret_expires_at: null | |
url: 'https://example.com/' | |
_links: | |
self: | |
href: 'http://finix.sandbox-payments-api.com/webhooks/WHmnVdiaimgD8aRTVvwuTZaj' | |
application: | |
href: 'http://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
_links: | |
self: | |
href: 'http://finix.sandbox-payments-api.com/notification/webhooks?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'http://finix.sandbox-payments-api.com/notification/webhooks?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'http://finix.sandbox-payments-api.com/notification/webhooks?offset=1360&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1197 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionEnrollment: | |
description: Single subscription_enrollment resource | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionEnrollment' | |
examples: | |
Subscription Enrollment: | |
value: | |
id: SUBENROLLMENT_Yxwo2Vb6oj97m3PuW9TxQ | |
created_at: '2022-02-02T01:47:08.07Z' | |
updated_at: '2022-02-02T01:47:08.07Z' | |
created_by: USimz3zSq5R2PqiEBXY6rSiJ | |
ended_at: null | |
merchant: MU7AxBA6MkF7Tee8veith3nG | |
nickname: Security Fee | |
started_at: '2022-11-11T16:50:59.89Z' | |
subscription_schedule: SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv | |
tags: | |
enrollment_info: Security Fee Enrollment | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments/SUBENROLLMENT_Yxwo2Vb6oj97m3PuW9TxQ' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MU7AxBA6MkF7Tee8veith3nG' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv/subscription_amounts' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionEnrollmentsList: | |
description: List of subscription_enrollment objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionEnrollmentList' | |
examples: | |
List of Subscription Enrollments: | |
value: | |
_embedded: | |
subscription_enrollments: | |
- id: SUBENROLLMENT_sJdhvD6x91qENUvnr2otgp | |
created_at: '2022-06-08T22:39:24.00Z' | |
updated_at: '2022-06-08T22:39:24.00Z' | |
created_by: USka4562gALVJRD471ddEmPc | |
ended_at: null | |
merchant: MUiysjyBGpiZEZYkzj7d5DhM | |
nickname: Vitameatavegamin Monthly | |
started_at: '2022-07-07T07:00:00.00Z' | |
subscription_schedule: SUBSCHEDULE_5GDvqCTAd6SrmWdsx4dUKx | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments/SUBENROLLMENT_sJdhvD6x91qENUvnr2otgp' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUiysjyBGpiZEZYkzj7d5DhM' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_5GDvqCTAd6SrmWdsx4dUKx' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_5GDvqCTAd6SrmWdsx4dUKx/subscription_amounts' | |
- id: SUBENROLLMENT_Yxwo2Vb6oj97m3PuW9TxQ | |
created_at: '2022-02-02T01:47:08.07Z' | |
updated_at: '2022-02-02T01:47:08.07Z' | |
created_by: USimz3zSq5R2PqiEBXY6rSiJ | |
ended_at: null | |
merchant: MU7AxBA6MkF7Tee8veith3nG | |
nickname: Security Fee | |
started_at: '2022-11-11T16:50:59.89Z' | |
subscription_schedule: SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv | |
tags: | |
enrollment_info: Security Fee Enrollment | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments/SUBENROLLMENT_Yxwo2Vb6oj97m3PuW9TxQ' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MU7AxBA6MkF7Tee8veith3nG' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_m77bRhJJ83oj9kBP3sYcv/subscription_amounts' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_enrollments?offset=840&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 2 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionAmount: | |
description: Single subscription_amount object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionAmount' | |
examples: | |
Subscription Amount: | |
value: | |
id: SUBAMOUNT_7qgPxRxYdRvN4LRXboYoeN | |
created_at: '2022-06-24T17:15:10.68Z' | |
updated_at: '2022-06-24T17:15:10.68Z' | |
amount_type: FEE | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fee_amount_data: | |
amount: 2500 | |
currency: USD | |
label: POS_INSTALLMENT_FEE | |
nickname: POS_INSTALLMENT_FEE | |
subscription_schedule: SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/SUBAMOUNT_7qgPxRxYdRvN4LRXboYoeN' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionAmountsList: | |
description: List of subscription_amount objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionAmountList' | |
examples: | |
List of Subscription Amounts: | |
value: | |
_embedded: | |
subscription_amounts: | |
- id: SUBAMOUNT_cTJQifghT2FLRR7ttJapXH | |
created_at: '2022-08-01T18:04:24.52Z' | |
updated_at: '2022-08-01T18:04:24.52Z' | |
amount_type: FEE | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fee_amount_data: | |
amount: 2500 | |
currency: USD | |
label: POS_INSTALLMENT_FEE | |
nickname: NEW_POS_INSTALLMENT_FEE | |
subscription_schedule: SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/SUBAMOUNT_cTJQifghT2FLRR7ttJapXH' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ' | |
- id: SUBAMOUNT_7qgPxRxYdRvN4LRXboYoeN | |
created_at: '2022-06-24T17:15:10.68Z' | |
updated_at: '2022-06-24T17:15:10.68Z' | |
amount_type: FEE | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fee_amount_data: | |
amount: 2500 | |
currency: USD | |
label: POS_INSTALLMENT_FEE | |
nickname: POS_INSTALLMENT_FEE | |
subscription_schedule: SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/SUBAMOUNT_7qgPxRxYdRvN4LRXboYoeN' | |
schedule: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uxsUJrgbQZEXsWm9toq6gZ/subscription_amounts/?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 2 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionSchedule: | |
description: Example response | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionSchedule' | |
examples: | |
Subscription Schedule - FIXED_TIME_INTERVAL: | |
value: | |
id: SUBSCHEDULE_uKKHic71ZD9FicJ89mhcNV | |
created_at: '2022-08-01T17:53:54.63Z' | |
updated_at: '2022-08-01T17:53:54.63Z' | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fixed_time_interval_offset: | |
hourly_interval: 24 | |
interval_count: 4 | |
line_item_type: FEE | |
nickname: Fixed_Time_Subscription_Schedule | |
period_offset: null | |
subscription_type: FIXED_TIME_INTERVAL | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uKKHic71ZD9FicJ89mhcNV' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uKKHic71ZD9FicJ89mhcNV/subscription_amounts' | |
Subscription Schedule - PERIODIC_MONTHLY: | |
value: | |
id: SUBSCHEDULE_uANjZPtZGzh4MK6aFFzbC8 | |
created_at: '2022-01-27T07:44:06.18Z' | |
updated_at: '2022-01-27T07:44:06.18Z' | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fixed_time_interval_offset: null | |
line_item_type: FEE | |
nickname: Monthly_Subscription_Schedule | |
period_offset: | |
day: 1 | |
month: null | |
subscription_type: PERIODIC_MONTHLY | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uANjZPtZGzh4MK6aFFzbC8' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uANjZPtZGzh4MK6aFFzbC8/subscription_amounts' | |
Subscription Schedule - PERIODIC_YEARLY: | |
value: | |
id: SUBSCHEDULE_uzbKGz4eHynQrn5ekkEAru | |
created_at: '2022-01-27T07:44:05.81Z' | |
updated_at: '2022-01-27T07:44:05.81Z' | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fixed_time_interval_offset: null | |
line_item_type: FEE | |
nickname: Yearly_Subscription_Schedule | |
period_offset: | |
day: 5 | |
month: 1 | |
subscription_type: PERIODIC_YEARLY | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uzbKGz4eHynQrn5ekkEAru' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_uzbKGz4eHynQrn5ekkEAru/subscription_amounts' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SubscriptionSchedulesList: | |
description: List of subscription_schedule objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SubscriptionSchedulesList' | |
examples: | |
List Subscription Schedules: | |
value: | |
_embedded: | |
subscription_schedules: | |
- id: SUBSCHEDULE_kfpANfUXxHyW2YBayXD39N | |
created_at: '2022-08-17T04:54:00.31Z' | |
updated_at: '2022-08-17T04:54:00.31Z' | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fixed_time_interval_offset: | |
hourly_interval: 24 | |
interval_count: 4 | |
line_item_type: FEE | |
nickname: Fixed_Time_Subscription_Schedule | |
period_offset: null | |
subscription_type: FIXED_TIME_INTERVAL | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_kfpANfUXxHyW2YBayXD39N' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_kfpANfUXxHyW2YBayXD39N/subscription_amounts' | |
- id: SUBSCHEDULE_rhbHGjhydMxsEXw4otBCFz | |
created_at: '2022-07-11T18:39:30.21Z' | |
updated_at: '2022-07-11T18:39:30.21Z' | |
created_by: UStxEci4vXxGDWLQhNvao7YY | |
fixed_time_interval_offset: | |
hourly_interval: 24 | |
interval_count: 4 | |
line_item_type: FEE | |
nickname: Fixed_Time_Subscription_Schedule | |
period_offset: null | |
subscription_type: FIXED_TIME_INTERVAL | |
tags: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_rhbHGjhydMxsEXw4otBCFz' | |
amounts: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/SUBSCHEDULE_rhbHGjhydMxsEXw4otBCFz/subscription_amounts' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/subscription/subscription_schedules/?offset=60&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 2 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
BalanceTransfer: | |
description: Single balance_transfer object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/BalanceTransfer' | |
examples: | |
Balance Transfer: | |
value: | |
id: BT_9SLA5BdQs6Z3xFpmjUoqhM | |
created_at: '2022-08-18T06:37:50.67Z' | |
updated_at: '2022-08-18T06:37:51.09Z' | |
amount: 101 | |
currency: USD | |
description: setup balance transfer for testing | |
destination: OPERATING_ACCOUNT | |
external_reference_id: '84077657260162531' | |
processor_type: LITLE_V1 | |
reference_id: FNX5ZJEGdPT5odwtRrvxVrYUn | |
source: FOR_BENEFIT_OF_ACCOUNT | |
state: SUCCEEDED | |
tags: | |
test_key_101: test_val_101 | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/BT_9SLA5BdQs6Z3xFpmjUoqhM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
BalanceTransferList: | |
description: List of balance_transfer objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/BalanceTransferList' | |
examples: | |
List of Balance Transfers: | |
value: | |
_embedded: | |
balance_transfers: | |
- id: BT_jXhKj7AcdQXvCANFfuowWa | |
created_at: '2022-10-10T08:07:35.69Z' | |
updated_at: '2022-10-10T08:07:35.92Z' | |
amount: 22725 | |
currency: USD | |
description: Test Balance Transfer | |
destination: FOR_BENEFIT_OF_ACCOUNT | |
external_reference_id: '84078027639024193' | |
processor_type: LITLE_V1 | |
reference_id: FNXBHeZiCJ4C4HcgpVGT5sdb | |
source: OPERATING_ACCOUNT | |
state: SUCCEEDED | |
tags: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/BT_jXhKj7AcdQXvCANFfuowWa' | |
- id: BT_qk8PK15fMsoXjZ1dP9YSwf | |
created_at: '2022-09-28T18:10:01.36Z' | |
updated_at: '2022-09-28T18:10:01.77Z' | |
amount: 4000 | |
currency: USD | |
description: Need to increase buffer given the high number of NSFs on merchant fee debits | |
destination: FOR_BENEFIT_OF_ACCOUNT | |
external_reference_id: '83989994584237171' | |
processor_type: LITLE_V1 | |
reference_id: FNXbECrND95wKrBh61D3Lrq7n | |
source: OPERATING_ACCOUNT | |
state: SUCCEEDED | |
tags: | |
example: documentation tag | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/BT_qk8PK15fMsoXjZ1dP9YSwf' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/?offset=20&limit=20&sort=created_at,desc&sort=id,desc' | |
last: | |
href: 'https://finix.sandbox-payments-api.com/balance_transfers/?offset=1280&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 1286 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
InstrumentUpdate: | |
description: Single instrument_update object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/InstrumentUpdate' | |
examples: | |
Instrument Updates: | |
value: | |
id: IUp9oSWhWUF31DPrJ8CojQeQ | |
created_at: '2020-12-02T03:44:42.77Z' | |
updated_at: '2020-12-02T03:44:42.81Z' | |
idempotency_id: 'F2022-08-12 15:05:19.211366' | |
merchant: MUvQQt3RKe7FBZ6j9eMYoo3H | |
state: PENDING | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payment_intrument_updates/IUp9oSWhWUF31DPrJ8CojQeQ' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
File: | |
description: Single File object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/File' | |
examples: | |
File - Created: | |
value: | |
id: FILE_abki8bFEjq51eZ5w2pYFik | |
created_at: '2022-08-16T18:50:25.770825Z' | |
updated_at: '2022-08-16T18:50:25.807321Z' | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
display_name: license_file | |
extension: null | |
identity_id: null | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
linked_type: MERCHANT | |
platform_id: PLm5E6FbtCZ5vjpCaKhq5PwN | |
status: REQUIRES_UPLOAD | |
tags: | |
test_key_100: test_val_100 | |
type: DRIVERS_LICENSE_FRONT | |
File - Uploading: | |
value: | |
id: FILE_abki8bFEjq51eZ5w2pYFik | |
created_at: '2022-08-16T18:50:25.770825Z' | |
updated_at: '2022-08-16T18:50:25.807321Z' | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
display_name: license_file | |
extension: png | |
identity_id: null | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
linked_type: MERCHANT | |
platform_id: PLm5E6FbtCZ5vjpCaKhq5PwN | |
status: PENDING | |
tags: | |
test_key_100: test_val_100 | |
type: DRIVERS_LICENSE_FRONT | |
File - Uploaded: | |
value: | |
id: FILE_abki8bFEjq51eZ5w2pYFik | |
created_at: '2022-08-16T18:50:25.770825Z' | |
updated_at: '2022-08-16T18:50:25.807321Z' | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
display_name: license_file | |
extension: png | |
identity_id: null | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
linked_type: MERCHANT | |
platform_id: PLm5E6FbtCZ5vjpCaKhq5PwN | |
status: UPLOADED | |
tags: | |
test_key_100: test_val_100 | |
type: DRIVERS_LICENSE_FRONT | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
FilesList: | |
description: List of File objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/FilesList' | |
examples: | |
List of Files: | |
value: | |
_embedded: | |
files: | |
- id: FILE_abki8bFEjq51eZ5w2pYFik | |
created_at: '2022-08-16T18:50:25.770825Z' | |
updated_at: '2022-08-16T18:50:25.807321Z' | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
display_name: license_file | |
extension: png | |
identity_id: null | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
linked_type: MERCHANT | |
platform_id: PLm5E6FbtCZ5vjpCaKhq5PwN | |
status: UPLOADED | |
tags: | |
test_key_100: test_val_100 | |
type: DRIVERS_LICENSE_FRONT | |
- id: FILE_eCecW4LCMMfY7nfnBrKpX8 | |
created_at: '2022-10-11T21:19:46.273063Z' | |
updated_at: '2022-10-11T21:19:46.296136Z' | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
display_name: My Drivers License | |
extension: null | |
identity_id: null | |
linked_to: MU2n7BSovtwYsWYZF6rBnnzk | |
linked_type: MERCHANT | |
platform_id: PLm5E6FbtCZ5vjpCaKhq5PwN | |
status: REQUIRES_UPLOAD | |
tags: | |
key_1: value_1 | |
type: DRIVERS_LICENSE_FRONT | |
page: | |
limit: 10 | |
next_cursor: FILE_abki8bFEjq51eZ5w2pYFik | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ExternalLink: | |
description: Single external_link object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ExternalLink' | |
examples: | |
External Link: | |
value: | |
id: EL_dh5YS66GePpkeSVyL4VdBL | |
created_at: '2022-03-22T01:07:05.074313Z' | |
duration: null | |
expired: true | |
expires_at: '2022-03-22T01:22:05.070415Z' | |
file_id: FILE_bJecqoRPasStEPVpvKHtgA | |
tags: {} | |
type: UPLOAD | |
url: 'https://finix-file-quarantine-sb.s3.us-east-2.amazonaws.com/MERCHANT/MU2n7BSovtwYsWYZF6rBnnzk/DRIVERS_LICENSE_FRONT/FILE_bJecqoRPasStEPVpvKHtgA/file?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJGMEQCIACy1Tl%2BahJzC4xuMTzdUk%2BdDsFeivMG1EUNFHJKqEImAiAm%2FlrPiF1gybEdzgjEqUoftwBL2qxaMtkitWG8UxKUayr6AwghEAIaDDM3NTYzNTU3MDA3MCIM%2BY%2BRbP5bgBMV0WafKtcD7z6X%2FLEz0mkHWYo45w8MZsJRox%2BS8gvWW0ufEcmC9OcA9%2BZSfBdPb4DstQulQZA5OKJ1I2mkqo5zKGcjhQ8uVzhKCEHfdnEB3Tm06ZY4L8sF9WyOV%2FTFbAQ0JzBQw6KPM0ubC0xaNIOnDXvfdzqt7nDLx6vC7Jxo%2FnIrmD37wkFeshib5YDtuU%2F6bBmPQqXU3PgmUODfWDfNj5Bqy6JhK5dqF0S0%2F09ny86v7jNZX%2BaNHc%2FV21mYUHYNSuwyJJLoeVC001dKebzxkXkfTbrKGAxaXz%2F3gVBX4OPwrwKR1nYxly4BtRay7vF8fWIPoJdHhdxiXEHYTNyJA%2FZbeHAjXlvVvvPximI73GzPYWxDj8K7ns%2BrshCRZboISSP0okwp%2FdgMPSa%2B73Z2pUbWdZILKvblgSRitDoL1baXQLd0S22EOHQS%2FXMLIB3wMPnY5ysuMNB%2FCjGLGO%2B1%2BxldCdzMeLIXacqkDG%2BiWxQV%2FPYTzMJor%2FcjvTbTaHI8IY1OKC17Q8Cms06VF9k8%2B1En5E0qSVJDxMRZy0Hdu8BVN%2FEpZvgLlNvLFkV%2FalCjmN4OHT5AOq%2Fb6V9Am%2FbXa7Eu8Z7%2BDiwv2OGz06UwsyRSb0G5iVx57EMAz0WGMMef5JEGOqYBsiwfoTFGtG9%2Ff2ib21I0VadcpBmX90lkty7tLS8VXaDOZFY3b5KZB%2FBWvkKym2YouCgSJTuxO6P2X15NRIm2tY4v7WhsOWQONcOONhuZCsU60fvEsVJnHV46IXGRAov%2BFHqMeOChYxUHoBaDA7UEG2yoXQdeMvk89c8m47fFFKzQq5jwlL5RTC1xgL1MdUespA32Bw5oalBq6bNAPrWI7yN67T75Ng%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220322T010705Z&X-Amz-SignedHeaders=host&X-Amz-Expires=899&X-Amz-Credential=ASIAVO5M75WLPYNTLOHA%2F20220322%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Signature=1172b039bd7e807c8c111280e3af1bb289cc70560519793a5749d60ab9e57971' | |
user_id: USsRhsHYZGBPnQw8CByJyEQW | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ExternalLinksList: | |
description: List of external_link objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ExternalLinksList' | |
examples: | |
List of External Links: | |
value: | |
_embedded: | |
external_links: | |
- id: EL_sVv61JP93htzDFTtNhbsdd | |
created_at: '2022-05-24T06:50:51.94704Z' | |
duration: null | |
expired: true | |
expires_at: '2022-05-24T07:05:51.934426Z' | |
file_id: FILE_bJecqoRPasStEPVpvKHtgA | |
tags: {} | |
type: UPLOAD | |
url: 'https://finix-file-quarantine-sb.s3.us-east-2.amazonaws.com/MERCHANT/MU2n7BSovtwYsWYZF6rBnnzk/DRIVERS_LICENSE_FRONT/FILE_bJecqoRPasStEPVpvKHtgA/file?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIb%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJIMEYCIQCRwhQF2A0kHmtOUShU8uI2g1JRbA0fxx%2Bkl5IGtZ6ygwIhAPSKP6KEEHYHhMqD54bqT%2Fzb495zGacrdZBEcGciNfZaKtMECHAQAhoMMzc1NjM1NTcwMDcwIgyA5j6IswvJUsAaiAoqsASHRDILId%2BbaQZiUOu29lOE9FmgXlw8uxpV3IiLMWmn2l4Iq8rTdANxXRVCM%2BWrT53DiBACQrUOSrmokWHfJ0DiizxD%2Fky06kDSbiVrD%2BK9DckqiBlg84N%2F7JKqyNeQUJKrUHtDKoH%2BSM%2FYNTgur%2BaGR07as8NG8qnhO8sJela5yWugYJjw4iJoZp%2BmOn%2BVL0Ry9OjEcoKxXCBDJF8W1ppa%2BRa1zfwpufJGWZYYZUiv31pVleRuCDyVef4p8MejnzRiEHFE4TNgcPYZW%2F97KRjQ9OYWbh7ygDuki9ejVdMICywCHEGLEtP%2Fr5EIU1IjWJUt6pwkjud2hHJ18f8j5U5j%2FFQF7wiTl3FlqqnXrLSHJaVA6fyJWbCTcfR%2B3Hr%2FbTSZWZWctXHO%2ByBYR1D9z9KhD%2FwaO87k0KRBRSggiMjVsgILguTdOeggcg3XyfUg2zRj6GPQF7HfBN%2FtGYoTO7l2IR6NBB7FBiusXzJMQd7IFC8fW%2BbiFlFmZk0IlGIUJcB2cetDEGL3k7McHOx9P7ywsy0f7wGdMTS01JgSOAt9Ic0nlljKj0dItwz1f%2FCIcm1%2FWvCZ2W6g0PbtM9dDEL04j3rIBm7spqqtx8KIj2hZs3cEkp8yr%2Bx%2B%2BZRXbMUnT7zNsEGShQGDVwxKP1sA834ZhF9KkC0RdRZFqvgXnC7Sk02tqSGVIUTzcymCl2jYfgiBfolPVW7cwEoIPOv%2FNEp%2BEHWZ7eJMP%2BiAnyMnXDkaGTCL97GUBjqoAQS5iN2Njmu0X6N5249v6JJ3HaoDqIE3p3A6IjwMK%2Byyx81LLYDkZTLVjo2t9DzPLjUy5TiTGd0mNt0Gp5fJ4vo4V5T2BnRWLTxS3tCrG69lTVWBEZfg9NniNhRwRsRrwW%2B%2BeJGIdt7E7CSciDB6fknhtALrh%2FtNKgqF4ofP8QxZedsz9FICsjt1On3r1BUqBLM9gZKdDvapil9PWDJeiRr24dbivHZfYg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220524T065051Z&X-Amz-SignedHeaders=host&X-Amz-Expires=899&X-Amz-Credential=ASIAVO5M75WLGNOGWHOG%2F20220524%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Signature=8d360d38a6752dba12fbebb2a83ad5c129b5fc475bf323f169fa826c6bca1b68' | |
user_id: USsRhsHYZGBPnQw8CByJyEQW | |
- id: EL_dh5YS66GePpkeSVyL4VdBL | |
created_at: '2022-03-22T01:07:05.074313Z' | |
duration: null | |
expired: true | |
expires_at: '2022-03-22T01:22:05.070415Z' | |
file_id: FILE_bJecqoRPasStEPVpvKHtgA | |
tags: {} | |
type: UPLOAD | |
url: 'https://finix-file-quarantine-sb.s3.us-east-2.amazonaws.com/MERCHANT/MU2n7BSovtwYsWYZF6rBnnzk/DRIVERS_LICENSE_FRONT/FILE_bJecqoRPasStEPVpvKHtgA/file?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEJj%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMiJGMEQCIACy1Tl%2BahJzC4xuMTzdUk%2BdDsFeivMG1EUNFHJKqEImAiAm%2FlrPiF1gybEdzgjEqUoftwBL2qxaMtkitWG8UxKUayr6AwghEAIaDDM3NTYzNTU3MDA3MCIM%2BY%2BRbP5bgBMV0WafKtcD7z6X%2FLEz0mkHWYo45w8MZsJRox%2BS8gvWW0ufEcmC9OcA9%2BZSfBdPb4DstQulQZA5OKJ1I2mkqo5zKGcjhQ8uVzhKCEHfdnEB3Tm06ZY4L8sF9WyOV%2FTFbAQ0JzBQw6KPM0ubC0xaNIOnDXvfdzqt7nDLx6vC7Jxo%2FnIrmD37wkFeshib5YDtuU%2F6bBmPQqXU3PgmUODfWDfNj5Bqy6JhK5dqF0S0%2F09ny86v7jNZX%2BaNHc%2FV21mYUHYNSuwyJJLoeVC001dKebzxkXkfTbrKGAxaXz%2F3gVBX4OPwrwKR1nYxly4BtRay7vF8fWIPoJdHhdxiXEHYTNyJA%2FZbeHAjXlvVvvPximI73GzPYWxDj8K7ns%2BrshCRZboISSP0okwp%2FdgMPSa%2B73Z2pUbWdZILKvblgSRitDoL1baXQLd0S22EOHQS%2FXMLIB3wMPnY5ysuMNB%2FCjGLGO%2B1%2BxldCdzMeLIXacqkDG%2BiWxQV%2FPYTzMJor%2FcjvTbTaHI8IY1OKC17Q8Cms06VF9k8%2B1En5E0qSVJDxMRZy0Hdu8BVN%2FEpZvgLlNvLFkV%2FalCjmN4OHT5AOq%2Fb6V9Am%2FbXa7Eu8Z7%2BDiwv2OGz06UwsyRSb0G5iVx57EMAz0WGMMef5JEGOqYBsiwfoTFGtG9%2Ff2ib21I0VadcpBmX90lkty7tLS8VXaDOZFY3b5KZB%2FBWvkKym2YouCgSJTuxO6P2X15NRIm2tY4v7WhsOWQONcOONhuZCsU60fvEsVJnHV46IXGRAov%2BFHqMeOChYxUHoBaDA7UEG2yoXQdeMvk89c8m47fFFKzQq5jwlL5RTC1xgL1MdUespA32Bw5oalBq6bNAPrWI7yN67T75Ng%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220322T010705Z&X-Amz-SignedHeaders=host&X-Amz-Expires=899&X-Amz-Credential=ASIAVO5M75WLPYNTLOHA%2F20220322%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Signature=1172b039bd7e807c8c111280e3af1bb289cc70560519793a5749d60ab9e57971' | |
user_id: USsRhsHYZGBPnQw8CByJyEQW | |
page: | |
limit: 10 | |
next_cursor: EL_dh5YS66GePpkeSVyL4VdBL | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
MerchantUpdated: | |
description: Single Merchant object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/Merchant' | |
examples: | |
Merchant - Disable a Merchant: | |
value: | |
id: MUeDVrf2ahuKc9Eg5TeZugvs | |
created_at: '2022-01-27T07:37:04.03Z' | |
updated_at: '2022-01-27T07:37:06.12Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: true | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
gateway: null | |
gross_settlement_enabled: false | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
level_two_level_three_data_enabled: true | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MP7tbAZ1RpjFycrfBVo6z4Ky | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
onboarding_state: APPROVED | |
processing_enabled: false | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
api_key: secretValue | |
ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
rent_surcharges_enabled: true | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VI5DBvVQ3ye5PcnUCSSvj84d | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MP7tbAZ1RpjFycrfBVo6z4Ky' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VI5DBvVQ3ye5PcnUCSSvj84d' | |
Merchant - Enable Buyer Charges: | |
value: | |
id: MUeDVrf2ahuKc9Eg5TeZugvs | |
created_at: '2022-01-27T07:37:04.03Z' | |
updated_at: '2022-01-27T07:37:06.12Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: true | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
gross_settlement_enabled: false | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
level_two_level_three_data_enabled: true | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MP7tbAZ1RpjFycrfBVo6z4Ky | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
api_key: secretValue | |
ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
rent_surcharges_enabled: true | |
settlement_enabled: true | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: true | |
tags: | |
key_2: value_2 | |
verification: VI5DBvVQ3ye5PcnUCSSvj84d | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MP7tbAZ1RpjFycrfBVo6z4Ky' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VI5DBvVQ3ye5PcnUCSSvj84d' | |
Merchant - Enable Level 2/3 Processing: | |
value: | |
id: MUeDVrf2ahuKc9Eg5TeZugvs | |
created_at: '2022-01-27T07:37:04.03Z' | |
updated_at: '2022-01-27T07:37:06.12Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: true | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: false | |
fee_ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
gross_settlement_enabled: false | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
level_two_level_three_data_enabled: true | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MP7tbAZ1RpjFycrfBVo6z4Ky | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
api_key: secretValue | |
ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
rent_surcharges_enabled: false | |
settlement_enabled: false | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VI5DBvVQ3ye5PcnUCSSvj84d | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MP7tbAZ1RpjFycrfBVo6z4Ky' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VI5DBvVQ3ye5PcnUCSSvj84d' | |
Merchant - Enable Partial Authorizations: | |
value: | |
id: MUeDVrf2ahuKc9Eg5TeZugvs | |
created_at: '2022-01-27T07:37:04.03Z' | |
updated_at: '2022-01-27T07:37:06.12Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
card_cvv_required: false | |
card_expiration_date_required: true | |
convenience_charges_enabled: true | |
creating_transfer_from_report_enabled: true | |
default_partial_authorization_enabled: true | |
fee_ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
gross_settlement_enabled: false | |
identity: IDuqZpDw28f2KK6YuDk4jNLg | |
level_two_level_three_data_enabled: true | |
mcc: '4900' | |
merchant_name: Finix Flowers | |
merchant_profile: MP7tbAZ1RpjFycrfBVo6z4Ky | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
onboarding_state: APPROVED | |
processing_enabled: true | |
processor: DUMMY_V1 | |
processor_details: | |
mid: FNXw5a7pBKHsCSgCAyQvU2soL | |
api_key: secretValue | |
ready_to_settle_upon: SUCCESSFUL_CAPTURE | |
rent_surcharges_enabled: false | |
settlement_enabled: false | |
settlement_funding_identifier: UNSET | |
surcharges_enabled: false | |
tags: | |
key_2: value_2 | |
verification: VI5DBvVQ3ye5PcnUCSSvj84d | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUeDVrf2ahuKc9Eg5TeZugvs/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MP7tbAZ1RpjFycrfBVo6z4Ky' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VI5DBvVQ3ye5PcnUCSSvj84d' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ApplePaySession: | |
description: Single apple_pay_session object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ApplePaySession' | |
examples: | |
Apple Pay Session: | |
value: | |
id: APPLEPAYSESSION_xxx | |
created_at: '2021-11-22T23:58:19.50Z' | |
updated_at: '2021-11-22T23:58:19.50Z' | |
session_details: '{"epochTimestamp":1640213041060,"expiresAt":1640216641060,"merchantSessionIdentifier":"SSH1524BA9006A944B8B9B8FB60227D9990_916523AAED1343F5BC5815E12BEE9250AFFDC1A17C46B0DE5A943F0F94927C24","nonce":"a5ee8554","merchantIdentifier":"23D5E1F154400B277E14CC8361878AA0AAFD46B2DF74003C7587B256269102BD","domainName":"tj.ngrok.io","displayName":"Christmas Shopping","signature":"...","operationalAnalyticsIdentifier":"Christmas Shopping:23D5E1F154400B277E14CC8361878AA0AAFD46B2DF74003C7587B256269102BD","retries":0}' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/apple_pay_sessions/APPLEPAYSESSION_xxx' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
AdjustmentTransfersList: | |
description: List of adjustment_transfer objects | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/AdjustmentTransfersList' | |
examples: | |
List of Adjustment Transfers in a Dispute: | |
value: | |
_embedded: | |
transfers: | |
- id: TRrqiR7x5zwUPV5SpPSbKH8B | |
created_at: '2022-01-27T07:43:03.94Z' | |
updated_at: '2022-01-27T07:43:03.48Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 888888 | |
amount_requested: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDddHpRqwf2VsH2XB1fmLfhM | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-01-27T07:43:03.91Z' | |
security_code_verification: null | |
source: null | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: PLATFORM_CREDIT | |
tags: {} | |
trace_id: c14d481c-60eb-4338-8331-9f34b3445710 | |
type: DISPUTE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrqiR7x5zwUPV5SpPSbKH8B' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDddHpRqwf2VsH2XB1fmLfhM' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrqiR7x5zwUPV5SpPSbKH8B/payment_instruments' | |
disputed_transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRrqiR7x5zwUPV5SpPSbKH8B/disputed_transfer' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPvCQUcnsueN3Bc3zR1qCBG8' | |
- id: TRw6U5auHfgKfgT4APKgkh4f | |
created_at: '2022-09-16T22:21:54.66Z' | |
updated_at: '2022-09-16T22:21:54.66Z' | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 888888 | |
amount_requested: 888888 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
destination: null | |
externally_funded: 'FALSE' | |
failure_code: null | |
failure_message: null | |
fee: 0 | |
idempotency_id: null | |
merchant_identity: IDpYDM7J9n57q849o9E9yNrG | |
messages: [] | |
raw: null | |
ready_to_settle_at: '2022-09-16T22:21:54.81Z' | |
security_code_verification: null | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
statement_descriptor: null | |
subtype: MERCHANT_CREDIT | |
tags: {} | |
trace_id: d5416d16-df58-4c9a-9759-076cb28800d5 | |
type: DISPUTE | |
_links: | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
self: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRw6U5auHfgKfgT4APKgkh4f' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRw6U5auHfgKfgT4APKgkh4f/payment_instruments' | |
disputed_transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRw6U5auHfgKfgT4APKgkh4f/disputed_transfer' | |
source: | |
href: 'https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137' | |
fee_profile: | |
href: 'https://finix.sandbox-payments-api.com/fee_profiles/FPq6PQ9pHsab66fKMmjQ7jb5' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/disputes/DIs7yQRkHDdMYhurzYz72SFk/adjustment_transfers?offset=0&limit=20&sort=created_at,desc&sort=id,desc' | |
page: | |
offset: 0 | |
limit: 20 | |
count: 4 | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
FileDownload: | |
description: Example response | |
content: | |
application/octet-stream: | |
schema: | |
$ref: '#/components/schemas/FileDownload' | |
examples: | |
Download Begins: | |
value: {} | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ComplianceForm: | |
description: Example response | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ComplianceForm' | |
examples: | |
Blank Compliance Form: | |
value: | |
id: cf_fEojUGLjwUiqNTBp68JWq8 | |
created_at: '2022-06-22T01:20:12.439149Z' | |
updated_at: '2022-07-06T17:32:00.328699Z' | |
application_id: APdoThHn4jjYUSxQf76txAgg | |
compliance_form_template: cft_wua8ua1yLAcHRK9mx2mF9K | |
due_at: '2022-09-20T01:20:12.430835Z' | |
files: | |
signed_file: null | |
unsigned_file: FILE_fFGMCY4sxGYTqpjnXh54kC | |
linked_to: MUfnskvHiiDgP7x3TVL2LkG3 | |
linked_type: MERCHANT | |
pci_saq_a: | |
ip_address: null | |
is_accepted: false | |
name: null | |
signed_at: null | |
title: null | |
user_agent: null | |
state: INCOMPLETE | |
tags: {} | |
type: PCI_SAQ_A | |
valid_from: '2022-06-22T01:20:12.978825Z' | |
valid_until: '2023-06-22T01:20:12.97883Z' | |
version: '2018.5' | |
Complete Compliance Form: | |
value: | |
id: cf_pqJFvPD3DXAnut1w6iNFK | |
created_at: '2023-07-06T22:18:19.806288Z' | |
updated_at: '2023-07-06T22:26:41.003926Z' | |
linked_to: MUqXc76t2KiqtikLni1zrMmW | |
linked_type: MERCHANT | |
application: APgix2NcQ9ETSPpVoqwSYUHx | |
type: PCI_SAQ_A | |
version: '2018.10' | |
valid_from: '2023-07-06T22:18:25.775726Z' | |
valid_until: '2024-07-05T22:18:25.77573Z' | |
tags: {} | |
pci_saq_a: | |
name: John Smith | |
signed_at: '2022-03-18T16:42:55Z' | |
user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
ip_address: 42.1.1.113 | |
is_accepted: true | |
title: CTO | |
due_at: '2023-10-04T22:18:19.790434Z' | |
compliance_form_template: cft_k6o6W33fdwnMXNxNhe4nfN | |
files: | |
unsigned_file: FILE_AwHMYuDX7w2d8hobjkxKD | |
signed_file: FILE_6E9ZpgGZJGmLcj2PiZzXHB | |
state: COMPLETE | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
InstrumentUpdateDownload: | |
description: "The updated `Payment Instruments` will be returned in the following comma seperated format:\n\npayment\\_instrument\\_original,\t| payment\\_instrument_new, |result\n--------------------------- | ---------------------- | -----\nPIlkNdfZibF8a7Prd2teGB1 | PI3aQGaCM5nDMjqyTXcbUJzR| CARD\\_EXPIRATION_UPDATED\nPIJPXW0HZ9lpO1nb6sog5DiX | PIdBHpy7BBSxd2z81VdKpVbT | CARD\\_NOT\\_FOUND\nPI0ovZAS9yfEtgDrZnMaiLvi | PIhXS0jXNTmklyVk91EsohuZ | CONTACT\\_CARDHOLDER\nPInOrrKY3G1U33hGYTQJ8cIY | | CLOSED\\_ACCOUNT\nPIlkAOt5kTVhuuxxbmOi9qn | | INVALID\\_CARD\nPIiRLbbG4i5daypWNzIrq2xD | | NO\\_CHANGE\\_FOUND\nPIy5llZGt6VxlDqbcTgATqeH | \t | UNKNOWN" | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/FileDownload' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
AuthorizationUpdated: | |
description: Single captured Authorization object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/AuthorizationCaptured' | |
examples: | |
Capture Authorization: | |
value: | |
id: AUbrumLihwhdLixtbU1mfMiF | |
created_at: '2022-10-06T20:22:42.25Z' | |
updated_at: '2022-10-07T17:09:22.85Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 118 | |
amount_requested: 118 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-13T20:22:42.25Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
test_key_101: test_val_101 | |
trace_id: 2724719e-6cc4-4cba-a859-2e6ac0bffb9b | |
transfer: TRs6APHuUAvSYq2FfTDkb5d8 | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUbrumLihwhdLixtbU1mfMiF' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRs6APHuUAvSYq2FfTDkb5d8' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Capture Authorization - Level 2 Processing: | |
value: | |
id: AUj9xCyjoNMxcJjaQw2GW7GZ | |
created_at: '2022-10-06T20:22:43.39Z' | |
updated_at: '2022-10-07T17:07:46.24Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 108 | |
amount_requested: 108 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-13T20:22:43.39Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
test_key_100: test_val_100 | |
trace_id: 20fb8474-1b04-433e-9573-d58e6fcc1586 | |
transfer: TRmGcgUgKxqpTVC2UVKngFsv | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUj9xCyjoNMxcJjaQw2GW7GZ' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRmGcgUgKxqpTVC2UVKngFsv' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Capture Authorization - Level 3 Processing: | |
value: | |
id: AUxgS2JLMnicqNYBpsViNQUp | |
created_at: '2022-09-28T19:07:52.44Z' | |
updated_at: '2022-10-10T06:43:53.74Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-05T19:07:52.44Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 99df414c-7afb-4d97-b3cd-3592a37eefa8 | |
transfer: TRskeVxUegfhhffGLFX4TEUa | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUxgS2JLMnicqNYBpsViNQUp' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRskeVxUegfhhffGLFX4TEUa' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Void Authorization: | |
value: | |
id: AUeYYckKJTrBVu1j8FYLzJ3W | |
created_at: '2022-10-07T18:25:23.30Z' | |
updated_at: '2022-10-07T18:29:59.38Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 100 | |
amount_requested: 100 | |
application: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
expires_at: '2022-10-14T18:25:23.30Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: true | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDuqZpDw28f2KK6YuDk4jNLg | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIe2YvpcjvoVJ6PzoRPBK137 | |
state: SUCCEEDED | |
tags: | |
order_number: 21DFASJSAKAS | |
trace_id: 560e44af-5d22-4af2-801e-03d2dad69dc7 | |
transfer: null | |
void_state: SUCCEEDED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUeYYckKJTrBVu1j8FYLzJ3W' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg' | |
Capture Card Present Authorization - EMV Card: | |
value: | |
id: AUuCfRve8QG6G1wnPCReiLma | |
created_at: '2022-10-06T20:22:42.25Z' | |
updated_at: '2022-10-07T17:09:22.85Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: POSTAL_CODE_AND_STREET_MATCH | |
amount: 150 | |
amount_requested: 118 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
card_present_details: null | |
currency: USD | |
device: DVsEanpBtsAVvCHbNXkFaH6f | |
expires_at: '2022-10-13T20:22:42.25Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: [] | |
raw: null | |
security_code_verification: MATCHED | |
source: PIjnHHLBZvRu6GPEZdFt7E2q | |
state: SUCCEEDED | |
tags: | |
order_number: chris123transfer | |
trace_id: 957ce193-b4e4-4a39-88e2-d88a019982d2 | |
transfer: TRjiUo5CXLmaJp4k9PL7iP8z | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUuCfRve8QG6G1wnPCReiLma' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRjiUo5CXLmaJp4k9PL7iP8z' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVsEanpBtsAVvCHbNXkFaH6f' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
Capture Card Present Authorization - Non-EMV Card: | |
value: | |
id: AUarp7Pz21Low4u2Urw5Ub4W | |
created_at: '2019-04-29T20:44:00.13Z' | |
updated_at: '2022-10-10T05:59:17.59Z' | |
3ds_redirect_url: null | |
additional_buyer_charges: null | |
additional_healthcare_data: null | |
address_verification: null | |
amount: 3138 | |
amount_requested: 3138 | |
application: APeUbTUjvYb1CdPXvNcwW1wP | |
capture_amount: 150 | |
card_present_details: | |
emv_data: | |
application_identifier: A0000001523010 | |
application_label: DISCOVER | |
application_preferred_name: null | |
application_transaction_counter: '0005' | |
cryptogram: ARCQ F666F8891F870D33 | |
issuer_code_table_index: null | |
pin_verified: false | |
tags: null | |
masked_account_number: '************0059' | |
name: Test Card 05 | |
brand: DISCOVER | |
entry_mode: CHIP_ENTRY | |
payment_type: CREDIT | |
approval_code: '004839' | |
currency: USD | |
device: DVfKLD9GZtsjcJxLtc2yCcfd | |
expires_at: '2019-05-06T20:44:00.13Z' | |
failure_code: null | |
failure_message: null | |
idempotency_id: null | |
is_void: false | |
merchant: MUeDVrf2ahuKc9Eg5TeZugvs | |
merchant_identity: IDsbTBawhnLBAVeinRb84vFR | |
messages: [] | |
raw: null | |
security_code_verification: null | |
source: PImTHaz7XVPx4M7mhu9x8gkU | |
state: SUCCEEDED | |
tags: | |
TicketNumber: '45878' | |
trace_id: FNX35FSuraeKKJr65wkGVFJni | |
transfer: TRqQCAX7nYHUnkE5YPFTknqd | |
void_state: UNATTEMPTED | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/authorizations/AUarp7Pz21Low4u2Urw5Ub4W' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP' | |
transfer: | |
href: 'https://finix.sandbox-payments-api.com/transfers/TRqQCAX7nYHUnkE5YPFTknqd' | |
device: | |
href: 'https://finix.sandbox-payments-api.com/devices/DVfKLD9GZtsjcJxLtc2yCcfd' | |
merchant_identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
OnboardingForm: | |
description: A single `onboarding_from` objext. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/OnboardingForm' | |
examples: | |
Onboarding Form: | |
value: | |
id: obf_cJUfiz97L8de54EwkC3Hiu | |
onboarding_data: | |
entity: | |
title: CEO | |
first_name: John | |
last_name: Smith | |
email: john.smith@finix.com | |
business_name: Finix Flowers | |
business_type: CORPORATION | |
doing_business_as: Finix Flowers | |
phone: '14158885080' | |
business_phone: '14158885080' | |
mcc: '4900' | |
url: 'https://www.finix.com' | |
ownership_type: PRIVATE | |
default_statement_descriptor: DEMOCOMPANY | |
max_transaction_amount: 100000 | |
annual_card_volume: '1000000' | |
principal_percentage_ownership: '75' | |
tax_id: '*****6789' | |
business_tax_id: '*****6789' | |
has_accepted_credit_cards_previously: false | |
personal_address: | |
line1: 123 Boren Ave | |
city: Seattle | |
region: WA | |
postal_code: '98040' | |
country: USA | |
business_address: | |
line1: 123 Bellevue Way | |
city: Bellevue | |
region: WA | |
postal_code: '98039' | |
country: USA | |
dob: | |
day: 13 | |
month: 4 | |
year: 1982 | |
incorporation_date: | |
day: 9 | |
month: 3 | |
year: 2018 | |
associated_entities: | |
- title: CFO | |
first_name: Alex | |
last_name: Smith | |
email: alex.smith@finix.com | |
phone: '14158885080' | |
personal_address: | |
line1: 4848 84th St | |
city: Bellevue | |
region: WA | |
postal_code: '98032' | |
country: USA | |
dob: | |
day: 13 | |
month: 4 | |
year: 1985 | |
principal_percentage_ownership: 25 | |
tax_id: '*****6789' | |
payment_instruments: | |
name: SARAH BANKER | |
bank_code: '123456789' | |
account_number: '*****6789' | |
account_type: CHECKING | |
type: BANK_ACCOUNT | |
additional_underwriting_data: | |
refund_policy: NO_REFUNDS | |
average_ach_transfer_amount: 2000000 | |
average_card_transfer_amount: 20000 | |
annual_ach_volume: 2000000 | |
business_description: CONSUMER | |
volume_distribution_by_business_type: | |
other_volume_percentage: 0 | |
person_to_person_volume_percentage: 0 | |
business_to_business_volume_percentage: 90 | |
business_to_consumer_volume_percentage: 10 | |
consumer_to_consumer_volume_percentage: 0 | |
card_volume_distribution: | |
ecommerce_percentage: 100 | |
card_present_percentage: 0 | |
mail_order_telephone_order_percentage: 0 | |
max_transaction_amount: 100000 | |
merchant_processors: | |
- processor: LITLE_V1 | |
onboarding_link_details: | |
return_url: 'https://www.finixflowers.com/' | |
expired_session_url: 'https://www.finixflowers.com/login' | |
fee_details_url: 'https://www.finixflowers.com/fee_details' | |
terms_of_service_url: 'https://www.finixflowers.com/ToS' | |
expiration_in_minutes: 10080 | |
onboarding_link: | |
expires_at: '2023-04-06T19:16:28.387Z' | |
link_url: 'https://sandbox.payments-dashboard.com/merchant-onboarding?formId=obf_cJUfiz97L8de54EwkC3Hiu&applicationId=APgPDQrLD52TYvqazjHJJchM...' | |
status: IN_PROGRESS | |
identity_id: null | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
created_at: '2023-03-30T19:16:28.377022Z' | |
updated_at: '2023-03-30T19:16:28.377022Z' | |
tags: {} | |
OnboardingFormLink: | |
description: A link for users to return to their `onboarding_form` at any time. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/OnboardingFormLink' | |
examples: | |
Onboarding Form Link: | |
value: | |
expires_at: '2022-07-11T22:39:55.469Z' | |
link_url: 'https://sandbox.payments-dashboard.com/merchant-onboarding?formId=obf_bXQj8iSgYwXf432yJcWbKv&applicationId=APgPDQrLD52TYvqazjHJJchM&bearerToken=eyJhbGciOiJIUzUxMiJ9.eyJvbmJvYXJkaW5nX2Zvcm1faWQiOiJvYmZfYlhRajhpU2dZd1hmNDMyeUpjV2JLdiIsImZlZV9kZXRhaWxzX3VybCI6Imh0dHBzOi8vd3d3LmZpbml4LmNvbS9kb2NzIiwiZXhwaXJlZF9zZXNzaW9uX3VybCI6Imh0dHBzOi8vd3d3LmZpbml4LmNvbS8iLCJpc3MiOiJodHRwczovL3d3dy5maW5peC5jb20iLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly93d3cuZmluaXguY29tL2RvY3MiLCJleHAiOjE2NTc1NzkxOTUsImFwcGxpY2F0aW9uX2lkIjoiQVBnUERRckxENTJUWXZxYXpqSEpKY2hNIiwiaWF0IjoxNjU3NTc3Mzk1LCJtZXJjaGFudF9tYXhfdHJhbnNhY3Rpb25fYW1vdW50IjoxMDAwMDAsInRlcm1zX29mX3NlcnZpY2VfdXJsIjoiaHR0cHM6Ly93d3cuZmluaXguY29tL3Rlcm1zLWFuZC1wb2xpY2llcyJ9.uQvwqhOxSmpX4zMSVn891ClNB_cWHmXhLfyOzRiKRoyn7VAqVOWrO8dJiY-OvN4venPWnPOxM0r3NiIyfgQv6g' | |
PayoutProfile: | |
description: '' | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PayoutProfile' | |
examples: | |
Payout Profile - Gross: | |
value: | |
id: POmhJeq1AsfwetG8LwhA4S9U | |
created_at: '2022-10-25T16:54:08.20Z' | |
updated_at: '2022-10-25T16:54:08.20Z' | |
linked_id: MU6TXYpA37uM9H4GwitQr8E3 | |
linked_type: MERCHANT | |
gross: | |
payouts: | |
frequency: DAILY | |
submission_delay_days: 1 | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
fees: | |
frequency: MONTHLY | |
day_of_month: 1 | |
submission_delay_days: 3 | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
tags: {} | |
type: GROSS | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles/POmhJeq1AsfwetG8LwhA4S9U' | |
Payout Profile - Net: | |
value: | |
id: POhiPobG6PoUteNVKpUauWVP | |
created_at: '2022-10-25T07:20:34.37Z' | |
updated_at: '2022-10-25T07:20:34.37Z' | |
linked_id: MU6TXYpA37uM9H4GwitQr8E3 | |
linked_type: MERCHANT | |
net: | |
frequency: CONTINUOUS | |
submission_delay_days: 1 | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: STANDARD | |
tags: {} | |
type: NET | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles/POhiPobG6PoUteNVKpUauWVP' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
PayoutProfilesList: | |
description: '' | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/PayoutProfilesList' | |
examples: | |
List of Payout Profiles: | |
value: | |
_embedded: | |
payout_profiles: | |
- id: PO6UbajkQrbFd5nAvs57dwyn | |
created_at: '2022-10-24T21:38:23.72Z' | |
updated_at: '2022-10-24T21:38:23.72Z' | |
tags: {} | |
linked_id: MU6TXYpA37uM9H4GwitQr8E3 | |
linked_type: MERCHANT | |
type: GROSS | |
gross: | |
payouts: | |
frequency: DAILY | |
submission_delay_days: 1 | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: SAME_DAY_ACH | |
fees: | |
frequency: MONTHLY | |
day_of_month: 1 | |
submission_delay_days: 3 | |
payment_instrument_id: PI2EmosKE8tvfSiF7Pd4SYE | |
rail: NEXT_DAY_ACH | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles/PO6UbajkQrbFd5nAvs57dwyn' | |
- id: POf5rP3c3XyRX7M6PuCvmgxf | |
created_at: '2022-10-20T19:43:18.02Z' | |
updated_at: '2022-10-20T19:43:18.02Z' | |
tags: {} | |
linked_id: MUfbbKm7vRmBX2bP92pKw9zZ | |
linked_type: MERCHANT | |
type: CUSTOM | |
custom: {} | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles/POf5rP3c3XyRX7M6PuCvmgxf' | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/payout_profiles?after_cursor=POf5rP3c3XyRX7M6PuCvmgxf' | |
page: | |
limit: 100 | |
next_cursor: POf5rP3c3XyRX7M6PuCvmgxf | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
ComplianceFormList: | |
description: List of `Compliance Form` objects. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/ComplianceFormList' | |
examples: | |
List of Compliance Forms: | |
value: | |
_embedded: | |
compliance_forms: | |
- id: cf_pqJFvPD3DXAnut1w6iNFK | |
created_at: '2023-07-06T22:18:19.806288Z' | |
updated_at: '2023-07-06T22:26:41.003926Z' | |
linked_to: MUqXc76t2KiqtikLni1zrMmW | |
linked_type: MERCHANT | |
application: APgix2NcQ9ETSPpVoqwSYUHx | |
type: PCI_SAQ_A | |
version: '2018.10' | |
valid_from: '2023-07-06T22:18:25.775726Z' | |
valid_until: '2024-07-05T22:18:25.77573Z' | |
tags: {} | |
pci_saq_a: | |
name: John Smith | |
signed_at: '2022-03-18T16:42:55Z' | |
user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
ip_address: 42.1.1.113 | |
is_accepted: true | |
title: CTO | |
due_at: '2023-10-04T22:18:19.790434Z' | |
compliance_form_template: cft_k6o6W33fdwnMXNxNhe4nfN | |
files: | |
unsigned_file: FILE_AwHMYuDX7w2d8hobjkxKD | |
signed_file: FILE_6E9ZpgGZJGmLcj2PiZzXHB | |
state: COMPLETE | |
page: | |
next_cursor: null | |
limit: 10 | |
SplitTransfer: | |
description: The `split_transfer` resource that was created from a split transacion. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SplitTransfer' | |
examples: | |
Split Transfer: | |
value: | |
id: split_transfer_7i2gxncPcfkN5rJwuhrb3q | |
created_at: '2023-07-19T02:30:17.10Z' | |
updated_at: '2023-07-19T02:30:17.10Z' | |
amount: 600 | |
fee: 0 | |
currency: USD | |
parent_transfer_id: TR7h8NxhCDHunLFdJ1HCLp4r | |
ready_to_settle_at: '2023-07-19T02:30:18.04Z' | |
type: DEBIT | |
merchant_id: MU4jpoNGRkAyjBxumZhGa6Hc | |
identity_id: IDhCtMvcteDx37eD9m4rmdKd | |
fee_profile_id: FPbDSnEPtaT8Nttxj9NJk7eC | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
tags: | |
key: value | |
Split Transfer - Refund: | |
value: | |
id: split_transfer_m7Y8kgx4nunsrVbuMdedDo | |
created_at: '2023-07-19T03:02:03.11Z' | |
updated_at: '2023-07-19T03:02:03.11Z' | |
amount: 600 | |
fee: 0 | |
currency: USD | |
parent_transfer_id: TRm23kdc4SCxYyva47RyiZv | |
ready_to_settle_at: '2023-07-19T03:03:03.21Z' | |
type: CREDIT | |
merchant_id: MU4jpoNGRkAyjBxumZhGa6Hc | |
identity_id: IDhCtMvcteDx37eD9m4rmdKd | |
fee_profile_id: FPbDSnEPtaT8Nttxj9NJk7eC | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
tags: | |
key: value | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
SplitTransfersList: | |
description: List of `split_transfers` created for a split `Transfer`. | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/SplitTransfersList' | |
examples: | |
List of Split Transfers: | |
value: | |
_embedded: | |
split_transfers: | |
- id: split_transfer_DQrLD52TYvqazjHJJchM | |
created_at: '2022-10-11T03:25:04.79Z' | |
updated_at: '2022-10-11T03:25:04.79Z' | |
amount: 600 | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
identity_id: IDxxx" | |
merchant_id: MUxxxx1 | |
parent_transfer_id: TRvQN3v5mhA2Ttc78hzjLV3j | |
ready_to_settle_at: '2022-10-11T03:25:05.32Z' | |
type: DEBIT | |
fee: null | |
- id: split_transfer_4MdY6eagpEqhtTaP8EBCR | |
created_at: '2022-10-11T03:25:04.79Z' | |
updated_at: '2022-10-11T03:25:04.79Z' | |
amount: 300 | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
identity_id: IDxxx" | |
merchant_id: MUxxxx1 | |
parent_transfer_id: TRvQN3v5mhA2Ttc78hzjLV3j | |
ready_to_settle_at: '2022-10-11T03:25:05.32Z' | |
type: DEBIT | |
fee: null | |
- id: split_transfer_4MdY6eagpEqhtTaP8EBCR | |
created_at: '2022-10-11T03:25:04.79Z' | |
updated_at: '2022-10-11T03:25:04.79Z' | |
amount: 100 | |
application_id: APgPDQrLD52TYvqazjHJJchM | |
currency: USD | |
identity_id: IDxxx" | |
merchant_id: MUxxxx1 | |
parent_transfer_id: TRvQN3v5mhA2Ttc78hzjLV3j | |
ready_to_settle_at: '2022-10-11T03:25:05.32Z' | |
type: DEBIT | |
fee: null | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/split_transfers?parent_transfer_id=TRvQN3v5mhA2Ttc78hzjLV3j' | |
next: | |
href: 'https://finix.sandbox-payments-api.com/transfers?limit=3&after_cursor=split_transfer_xxx' | |
page: | |
limit: 3 | |
next_cursor: split_transfer_xxx | |
MerchantPIVerification: | |
description: Single Verification object | |
content: | |
application/json: | |
schema: | |
$ref: '#/components/schemas/MerchantPIVerification' | |
examples: | |
Merchant - Reverify a Merchant: | |
value: | |
id: VIecViWTa71vFvgTgD3m8pyL | |
created_at: '2023-10-17T23:50:21.71Z' | |
updated_at: '2023-10-17T23:50:21.76Z' | |
application: APgPDQrLD52TYvqazjHJJchM | |
identity: null | |
merchant: MUucec6fHeaWo3VHYoSkUySM | |
merchant_identity: IDpYDM7J9n57q849o9E9yNrG | |
messages: [] | |
payment_instrument: null | |
payment_instrument_verification_details: | |
push_to_card_domestic: null | |
push_to_card_cross_border: null | |
card_type: null | |
billing_currency: null | |
issuer_country: null | |
processor: DUMMY_V1 | |
raw: null | |
state: PENDING | |
tags: {} | |
trace_id: 7ba9a29a-8988-48bb-9c0e-3b1889aa1f6c | |
type: MERCHANT | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIecViWTa71vFvgTgD3m8pyL' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
merchant: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUucec6fHeaWo3VHYoSkUySM' | |
headers: | |
finix-apiuser-role: | |
$ref: '#/components/headers/finix-apiuser-role' | |
date: | |
$ref: '#/components/headers/date' | |
x-request-id: | |
$ref: '#/components/headers/x-request-id' | |
schemas: | |
Application: | |
type: object | |
properties: | |
id: | |
type: string | |
example: APxxxxxxxxxxxxxxxxxx | |
description: ID of the `Application` resource. | |
created_at: | |
type: string | |
description: Point in time when this object was created. | |
format: date-time | |
updated_at: | |
type: string | |
description: Point in time when this object was most recently updated. | |
format: date-time | |
card_cvv_required: | |
type: boolean | |
description: Details if the `Application` requires CVV code. | |
card_expiration_date_required: | |
type: boolean | |
description: Details if the `Application` requires the card's expiration date. | |
creating_transfer_from_report_enabled: | |
type: boolean | |
description: Details if the `Application` is automatically set to create `Transfers` once settlement reports get generated. | |
enabled: | |
type: boolean | |
description: Details if the `Application` is enabled and active. Set to **false** to disable the `Application`. | |
fee_ready_to_settle_upon: | |
type: string | |
enum: | |
- RECONCILIATION | |
- SUCCESSFUL_CAPTURE | |
description: Details when the `fees` of `Authroizations` submitted under the `Application` will be ready to settle. | |
nullable: true | |
name: | |
type: string | |
description: The name of the `Application`. | |
owner: | |
type: string | |
example: IDxxxxxxxxxxxxxxxxxx | |
description: ID of the `Identity` resource that created the `Application`. | |
processing_enabled: | |
type: boolean | |
description: 'Details if transaction processing is enabled for the `Application`. ' | |
ready_to_settle_upon: | |
type: string | |
enum: | |
- RECONCILIATION | |
- SUCCESSFUL_CAPTURE | |
description: Details when transactions submitted under the `Application` will be ready to settle. | |
nullable: true | |
settlement_enabled: | |
type: boolean | |
description: 'Details if settlement processing is enabled for the `Application`. ' | |
settlement_funding_identifier: | |
type: string | |
enum: | |
- UNSET | |
- MID_AND_DATE | |
- MID_AND_MERCHANT_NAME | |
default: UNSET | |
description: |- | |
Includes additional information (like the MID or `Merchant` name) when submitting funding `Transfers` to processors. | |
- **UNSET**: No additional details get provided to the processor. | |
- **MID_AND_DATE**: The `MID` of the `Merchant` and the date the funding `Transfer` was submitted (Date is in UTC). e.g **MID:12345678-20220225** | |
- **MID_AND_MERCHANT_NAME**: The `MID` of the `Merchant` and the `Merchant#name` (white spaces will be removed). e.g. **MID:12345678-NameOfMerchant** | |
These details appear alongside the seller's payout in their bank account as a description of the deposit. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
authorizations: | |
type: object | |
properties: | |
href: | |
type: string | |
application_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
disputes: | |
type: object | |
properties: | |
href: | |
type: string | |
identities: | |
type: object | |
properties: | |
href: | |
type: string | |
merchants: | |
type: object | |
properties: | |
href: | |
type: string | |
owner_identity: | |
type: object | |
properties: | |
href: | |
type: string | |
payment_instruments: | |
type: object | |
properties: | |
href: | |
type: string | |
processors: | |
type: object | |
properties: | |
href: | |
type: string | |
reversals: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
settlements: | |
type: object | |
properties: | |
href: | |
type: string | |
tokens: | |
type: object | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
properties: | |
href: | |
type: string | |
users: | |
type: object | |
properties: | |
href: | |
type: string | |
webhooks: | |
type: object | |
properties: | |
href: | |
type: string | |
CreateApplicationRequest: | |
type: object | |
x-examples: {} | |
properties: | |
entity: | |
type: object | |
title: IdentityEntityForm | |
description: Information needed to verify the identity of the entity. | |
properties: | |
amex_mid: | |
type: string | |
description: Assigned amex_Mid value. If included must be 10 or 11 digits. | |
nullable: true | |
annual_card_volume: | |
type: integer | |
format: int64 | |
description: Approximate annual credit card sales expected to be processed in cents by this seller (max 19 characters). | |
business_address: | |
type: object | |
description: Primary address for the legal entity. | |
required: | |
- city | |
- country | |
- line1 | |
- postal_code | |
- region | |
nullable: true | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
nullable: true | |
country: | |
type: string | |
enum: | |
- ABW | |
- AFG | |
- AGO | |
- AIA | |
- ALA | |
- ALB | |
- AND | |
- ARE | |
- ARG | |
- ARM | |
- ASM | |
- ATA | |
- ATF | |
- ATG | |
- AUS | |
- AUT | |
- AZE | |
- BDI | |
- BEL | |
- BEN | |
- BES | |
- BFA | |
- BGD | |
- BGR | |
- BHR | |
- BHS | |
- BIH | |
- BLM | |
- BLR | |
- BLZ | |
- BMU | |
- BOL | |
- BRA | |
- BRB | |
- BRN | |
- BTN | |
- BVT | |
- BWA | |
- CAF | |
- CAN | |
- CCK | |
- CHE | |
- CHL | |
- CHN | |
- CIV | |
- CMR | |
- COD | |
- COG | |
- COK | |
- COL | |
- COM | |
- CPV | |
- CRI | |
- CUB | |
- CUW | |
- CXR | |
- CYM | |
- CYP | |
- CZE | |
- DEU | |
- DJI | |
- DMA | |
- DNK | |
- DOM | |
- DZA | |
- ECU | |
- EGY | |
- ERI | |
- ESH | |
- ESP | |
- EST | |
- ETH | |
- FIN | |
- FJI | |
- FLK | |
- FRA | |
- FRO | |
- FSM | |
- GAB | |
- GBR | |
- GEO | |
- GGY | |
- GHA | |
- GIB | |
- GIN | |
- GLP | |
- GMB | |
- GNB | |
- GNQ | |
- GRC | |
- GRD | |
- GRL | |
- GTM | |
- GUF | |
- GUM | |
- GUY | |
- HKG | |
- HMD | |
- HND | |
- HRV | |
- HTI | |
- HUN | |
- IDN | |
- IMN | |
- IND | |
- IOT | |
- IRL | |
- IRN | |
- IRQ | |
- ISL | |
- ISR | |
- ITA | |
- JAM | |
- JEY | |
- JOR | |
- JPN | |
- KAZ | |
- KEN | |
- KGZ | |
- KHM | |
- KIR | |
- KNA | |
- KOR | |
- KWT | |
- LAO | |
- LBN | |
- LBR | |
- LBY | |
- LCA | |
- LIE | |
- LKA | |
- LSO | |
- LTU | |
- LUX | |
- LVA | |
- MAC | |
- MAF | |
- MAR | |
- MCO | |
- MDA | |
- MDG | |
- MDV | |
- MEX | |
- MHL | |
- MKD | |
- MLI | |
- MLT | |
- MMR | |
- MNE | |
- MNG | |
- MNP | |
- MRT | |
- MSR | |
- MTQ | |
- MUS | |
- MWI | |
- MYS | |
- MYT | |
- NAM | |
- NCL | |
- NER | |
- NFK | |
- NGA | |
- NIC | |
- NIU | |
- NLD | |
- NOR | |
- NPL | |
- NRU | |
- NZL | |
- OMN | |
- PAK | |
- PAN | |
- PCN | |
- PER | |
- PHL | |
- PLW | |
- PNG | |
- POL | |
- PRI | |
- PRK | |
- PRT | |
- PRY | |
- PSE | |
- PYF | |
- QAT | |
- REU | |
- ROU | |
- RUS | |
- RWA | |
- SAU | |
- SDN | |
- SEN | |
- SGP | |
- SGS | |
- SHN | |
- SJM | |
- SLB | |
- SLE | |
- SLV | |
- SMR | |
- SOM | |
- SPM | |
- SRB | |
- SSD | |
- STP | |
- SUR | |
- SVK | |
- SVN | |
- SWE | |
- SWZ | |
- SXM | |
- SYC | |
- SYR | |
- TCA | |
- TCD | |
- TGO | |
- THA | |
- TJK | |
- TKL | |
- TKM | |
- TLS | |
- TON | |
- TTO | |
- TUN | |
- TUR | |
- TUV | |
- TWN | |
- TZA | |
- UGA | |
- UKR | |
- UMI | |
- URY | |
- USA | |
- UZB | |
- VAT | |
- VCT | |
- VEN | |
- VGB | |
- VIR | |
- VNM | |
- VUT | |
- WLF | |
- WSM | |
- XKX | |
- YEM | |
- ZAF | |
- ZMB | |
- ZWE | |
description: 3-Letter Country code. | |
nullable: true | |
line1: | |
type: string | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
postal_code: | |
type: string | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
region: | |
type: string | |
description: 2-letter State code. | |
nullable: true | |
business_name: | |
type: string | |
description: 'Merchant''s full legal business name (If **INDIVIDUAL\_SOLE\_PROPRIETORSHIP**, input first name, Full legal last name and middle initial; max 120 characters)' | |
nullable: true | |
business_phone: | |
type: string | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
business_tax_id: | |
type: string | |
description: 'Nine digit Tax Identification Number (TIN), Employer Identification Number (EIN). If the `business_type` is **INDIVIDUAL\_SOLE\_PROPRIETORSHIP** and they do not have an EIN, use the sole proprietor''s Social Security Number (SSN).' | |
business_type: | |
type: string | |
enum: | |
- INDIVIDUAL_SOLE_PROPRIETORSHIP | |
- CORPORATION | |
- LIMITED_LIABILITY_COMPANY | |
- PARTNERSHIP | |
- LIMITED_PARTNERSHIP | |
- GENERAL_PARTNERSHIP | |
- ASSOCIATION_ESTATE_TRUST | |
- TAX_EXEMPT_ORGANIZATION | |
- INTERNATIONAL_ORGANIZATION | |
- GOVERNMENT_AGENCY | |
- JOINT_VENTURE | |
description: Include the value that applies the best. | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
maxLength: 20 | |
minLength: 1 | |
description: Billing description displayed on the buyer's bank or card statement (Length must be between 1 and 20 characters). | |
discover_mid: | |
type: string | |
description: Assigned Discover Mid value. | |
dob: | |
type: object | |
format: date | |
description: The principal control owner's date of birth. | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
year: | |
type: integer | |
description: Year of birth (4-digit). | |
doing_business_as: | |
type: string | |
maxLength: 60 | |
description: Alternate name of the business. If no other name is used use the same value used in `business_name` (max 60 characters). | |
email: | |
type: string | |
description: Control person's email address where they can be reached (max 100 characters). | |
first_name: | |
type: string | |
description: Full legal first name of the merchant's principal representative (max 20 characters). | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
description: Full legal last name of the merchant's principal representative (max 20 characters). | |
max_transaction_amount: | |
type: integer | |
format: int64 | |
description: Maximum amount that can be transacted for a single transaction in cents (max 12 characters). | |
mcc: | |
type: string | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
ownership_type: | |
type: string | |
nullable: true | |
enum: | |
- PRIVATE | |
- PUBLIC | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
personal_address: | |
$ref: '#/components/schemas/Address' | |
phone: | |
type: string | |
description: Principal's phone number (max 10 characters). | |
principal_percentage_ownership: | |
type: integer | |
format: int64 | |
maximum: 100 | |
minimum: 0 | |
description: Percentage of company owned by the principal (min 0; max 100). | |
short_business_name: | |
type: string | |
maxLength: 16 | |
minLength: 1 | |
description: |- | |
The short version of the business name. | |
(Defaults to **null**). | |
tax_authority: | |
type: string | |
description: Used and required when onboarding a `Merchant` with a `MCC` of **9311**. The `tax_authority` is the tax gathering entity (e.g San Francisco Water Authority). | |
tax_id: | |
type: string | |
description: Used to verify `tax_id` was provided. | |
title: | |
type: string | |
maxLength: 60 | |
description: 'Control person''s corporate title or role (i.e. Chief Executive Officer, CFO, etc.; max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
description: Merchant's publicly available website (max 100 characters). | |
required: | |
- business_address | |
- business_name | |
- business_phone | |
- business_tax_id | |
- business_type | |
- dob | |
- doing_business_as | |
- first_name | |
- last_name | |
- personal_address | |
- phone | |
- tax_id | |
max_transaction_amount: | |
type: integer | |
description: Maximum amount that can be processed for a single transaction in cents (max 12 characters). | |
nullable: true | |
name: | |
type: string | |
description: 'Merchant''s full legal business name (If **INDIVIDUAL_SOLE_PROPRIETORSHIP**, enter first name, Full legal last name and middle initial; max 120 characters).' | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
user: | |
type: string | |
example: USxxxxxxxxxxxxxxxxxx | |
description: ID of the `User` resource. | |
required: | |
- user | |
ApplicationProfile: | |
type: object | |
properties: | |
id: | |
type: string | |
example: PPxxxxxxxxxxxxxxxxxx | |
description: ID of the `application_profile` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource. | |
fee_profile: | |
type: string | |
example: FPxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Fee Profile` associated with the `Application`. | |
nullable: true | |
risk_profile: | |
type: string | |
example: RPxxxxxxxxxxxxxxxxxx | |
description: The ID of the `risk_profile` that was created during provisioning. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
fee_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
risk_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
UpdateApplicationProfileRequest: | |
type: object | |
properties: | |
fee_profile: | |
type: object | |
description: The ID of the `Fee Profile` associated with the `Application`. | |
risk_profile: | |
type: object | |
description: The ID of the `Risk Profile` associated with the `Application`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
ApplicationProfilesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `application_profile` resources. | |
properties: | |
application_profiles: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`application_profile` resources.' | |
items: | |
$ref: '#/components/schemas/ApplicationProfile' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
ApplicationsList: | |
type: object | |
description: '' | |
title: ApplicationsList | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `Application` resources. | |
properties: | |
applications: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Application` resources.' | |
items: | |
$ref: '#/components/schemas/Application' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
CreateAuthorizationRequest: | |
anyOf: | |
- title: Authorization | |
properties: | |
additional_buyer_charges: | |
$ref: '#/components/schemas/AdditionalBuyerCharges' | |
additional_purchase_data: | |
$ref: '#/components/schemas/AdditionalPurchaseData' | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
device: | |
type: string | |
description: The ID of the `Device` that the `Authorization` was created under. | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
hsa_fsa_payment: | |
$ref: '#/components/schemas/HSAFSAPayment' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
operation_key: | |
$ref: '#/components/schemas/OperationKey' | |
security_code: | |
type: string | |
description: 'The 3-4 digit security code for the card (i.e. CVV code). Include the CVV code of the card to include [Card Verification Checks](/guides/payments/making-a-payment/card-verification-checks/) with the created `Authorization`.' | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
3d_secure_authentication: | |
type: object | |
description: The 3D secure information required to create a 3D secure `Authorization`. | |
nullable: true | |
properties: | |
cardholder_authentication: | |
type: string | |
description: Provides evidence that the cardholder authentication occurred or that the merchant attempted authentication. This is unique for each authentication transaction. | |
cardholder_ip_address: | |
type: string | |
description: Only required for **American Express** cards. | |
example: 189.1.126.240 | |
electronic_commerce_indicator: | |
type: string | |
description: |- | |
- **AUTHENTICATED**: Approved by 3D Secure Vendor. | |
- **ATTEMPTED**: Issuer or cardholder doesn't support 3D Secure. | |
transaction_id: | |
type: string | |
description: Only required for **Visa** cards. | |
required: | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Authorization - 3D Secure | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
3d_secure_authentication: | |
type: object | |
description: The 3D secure information required to create a 3D secure `Authorization.` | |
nullable: true | |
properties: | |
cardholder_authentication: | |
type: string | |
description: Provides evidence that the cardholder authentication occurred or that the merchant attempted authentication. This is unique for each authentication transaction. | |
cardholder_ip_address: | |
type: string | |
description: Only required for **American Express** cards. | |
example: 189.1.126.240 | |
electronic_commerce_indicator: | |
type: string | |
description: |- | |
- **AUTHENTICATED**: Approved by 3D Secure Vendor. | |
- **ATTEMPTED**: Issuer or cardholder doesn't support 3D Secure. | |
transaction_id: | |
type: string | |
description: Only required for **Visa** cards. | |
required: | |
- cardholder_authentication | |
- electronic_commerce_indicator | |
required: | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Authorization - Authorization with CVV | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
security_code: | |
type: string | |
description: 'The 3-4 digit security code for the card (i.e. CVV code). Include the CVV code of the card to include [Card Verification Checks](/guides/payments/making-a-payment/card-verification-checks/) with the created `Authorization`.' | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- merchant | |
- security_code | |
- source | |
- title: Authorization - Buyer Charges | |
properties: | |
additional_buyer_charges: | |
$ref: '#/components/schemas/AdditionalBuyerCharges' | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
security_code: | |
type: string | |
description: 'The 3-4 digit security code for the card (i.e. CVV code). Include the CVV code of the card to include [Card Verification Checks](/guides/payments/making-a-payment/card-verification-checks/) with the created `Authorization`.' | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- additional_buyer_charges | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Authorization - HSA or FSA Card | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
hsa_fsa_payment: | |
$ref: '#/components/schemas/HSAFSAPayment' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- hsa_fsa_payment | |
- merchant | |
- source | |
- title: Authorization - Level 2 Processing | |
properties: | |
additional_purchase_data: | |
$ref: '#/components/schemas/AdditionalPurchaseData' | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
3d_secure_authentication: | |
type: object | |
description: The 3D secure information required to create a 3D secure `Authorization.` | |
nullable: true | |
properties: | |
cardholder_authentication: | |
type: string | |
description: Provides evidence that the cardholder authentication occurred or that the merchant attempted authentication. This is unique for each authentication transaction. | |
cardholder_ip_address: | |
type: string | |
description: Only required for **American Express** cards. | |
example: 189.1.126.240 | |
electronic_commerce_indicator: | |
type: string | |
description: |- | |
- **AUTHENTICATED**: Approved by 3D Secure Vendor. | |
- **ATTEMPTED**: Issuer or cardholder doesn't support 3D Secure. | |
transaction_id: | |
type: string | |
description: Only required for **Visa** cards. | |
required: | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Authorization - Level 3 Processing | |
properties: | |
'additional_purchase_data ': | |
$ref: '#/components/schemas/L3AdditionalPurchaseData' | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Authorization - Partial Authorization | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
merchant: | |
type: string | |
description: The ID of the `Merchant` that the `Authorization` was created under. | |
partial_authorization: | |
type: boolean | |
description: |- | |
- Set to **true** if you want to enable partial authorizations for a specific transaction. | |
- If `partial_authorization` is enabled for an individual transaction, the `Merchant` value for `default_partial_authorization_enabled` is disregarded. | |
- Partial authorizations enable you to collect a portion of the amount if the cardholder does not have the funds to cover the entire amount. | |
source: | |
type: string | |
description: The ID of the `Payment Instrument` that will be debited and performing the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- merchant | |
- source | |
- title: Card Present Authorization - EMV Card | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
device: | |
type: string | |
description: The ID of the `Device` that the `Authorization` was created under. | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
operation_key: | |
$ref: '#/components/schemas/OperationKey' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- device | |
- operation_key | |
- title: Card Present Authorization - Non-EMV Card | |
properties: | |
amount: | |
format: int64 | |
type: integer | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
currency: | |
$ref: '#/components/schemas/Currency' | |
device: | |
type: string | |
description: The ID of the `Device` that the `Authorization` was created under. | |
fraud_session_id: | |
$ref: '#/components/schemas/FraudSessionID' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
operation_key: | |
$ref: '#/components/schemas/OperationKey' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- device | |
- operation_key | |
type: object | |
Authorization: | |
type: object | |
title: Authorization | |
description: A charge authorization | |
properties: | |
id: | |
type: string | |
example: AUxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Authorization` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
3ds_redirect_url: | |
type: string | |
description: The redirect URL used for 3DS transactions (if supported by the processor). | |
nullable: true | |
address_verification: | |
type: string | |
description: Details the results of the Address Verification checks. | |
nullable: true | |
additional_buyer_charges: | |
$ref: '#/components/schemas/AdditionalBuyerCharges' | |
additional_healthcare_data: | |
$ref: '#/components/schemas/AdditionalHealthcareData' | |
additional_purchase_data: | |
$ref: '#/components/schemas/AdditionalPurchaseData' | |
amount: | |
type: integer | |
minimum: 0 | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
amount_requested: | |
type: integer | |
description: 'When `default_partial_authorization_enabled` is set to **true**, `amount_requested` indicates the amount the cardholder attempted to authorize.' | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Authorization` was created under. | |
card_present_details: | |
$ref: '#/components/schemas/CardPresentDetails' | |
capture_amount: | |
type: integer | |
format: int64 | |
description: The amount of the `Authorization` you would like to capture in cents. Must be less than or equal to the `amount` of the `Authorization`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
device: | |
type: string | |
example: DVxxxxxxxxxxxxxxxxxx | |
description: The ID of the activated device. | |
nullable: true | |
expires_at: | |
type: string | |
description: '`Authorization` expiration time.' | |
format: date-time | |
failure_code: | |
$ref: '#/components/schemas/FailureCode' | |
failure_message: | |
$ref: '#/components/schemas/FailureMessage' | |
security_code_checks: | |
type: string | |
description: Details the results of the Security Code Verification checks. | |
nullable: true | |
is_void: | |
type: boolean | |
description: Details if the `Authorization` is void. | |
merchant: | |
type: string | |
example: MUxxxxxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Merchant` resource the `Authorization` was created under. | |
merchant_identity: | |
type: string | |
example: IDxxxxxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Identity` resource used by the `Merchant` the `Authorization` was processed under. | |
messages: | |
type: array | |
description: Message field that provides additional details. This field is typically **null**. | |
nullable: true | |
items: | |
type: string | |
raw: | |
$ref: '#/components/schemas/Raw' | |
security_code_verification: | |
type: string | |
description: Details the results of the Security Code Verification che | |
nullable: true | |
source: | |
type: string | |
example: PIxxxxxxxxxxxxxxxxxx | |
description: ID of the `Payment Instrument` where funds get debited. | |
state: | |
type: string | |
enum: | |
- CANCELED | |
- PENDING | |
- FAILED | |
- SUCCEEDED | |
- UNKNOWN | |
description: The state of the `Authorization`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
trace_id: | |
type: string | |
description: Trace ID of the `Authorization`. The processor sends back the `trace_id` so you can track the authorization end-to-end. | |
transfer: | |
type: string | |
example: TRxxxxxxxxxxxxxxxxxx | |
description: The ID of the `transfer` resource that gets created when the `Authorization` moves to **SUCCEEDED**. | |
nullable: true | |
void_state: | |
type: string | |
description: Details if the `Authorization` has been voided. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
device: | |
type: object | |
description: Link to the `Device` the request was made under. | |
properties: | |
href: | |
type: string | |
merchant_identity: | |
type: object | |
description: Link to the `Identity` the `Merchant` was created under and the `Transfer` was submitted with. | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfer: | |
type: object | |
description: Link to the `Transfers` realted to the `Authorization`. | |
properties: | |
href: | |
type: string | |
AuthorizationCaptured: | |
type: object | |
title: AuthorizationCaptured | |
description: A captured authorization | |
properties: | |
id: | |
type: string | |
example: AUxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Authorization` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
3ds_redirect_url: | |
type: string | |
description: The redirect URL used for 3DS transactions (if supported by the processor). | |
nullable: true | |
additional_buyer_charges: | |
$ref: '#/components/schemas/AdditionalBuyerCharges' | |
amount: | |
type: integer | |
minimum: 0 | |
description: The total amount that will be debited in cents (e.g. 100 cents to debit $1.00). | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Authorization` was created under. | |
card_present_details: | |
$ref: '#/components/schemas/CardPresentDetails' | |
capture_amount: | |
type: integer | |
format: int64 | |
description: The amount of the `Authorization` you would like to capture in cents. Must be less than or equal to the `amount` of the `Authorization`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
device: | |
type: string | |
example: DVxxxxxxxxxxxxxxxxxx | |
description: The ID of the activated device. | |
nullable: true | |
expires_at: | |
type: string | |
description: Authorization expiration time. | |
format: date-time | |
external_responses: | |
type: array | |
nullable: true | |
items: | |
type: object | |
properties: | |
body: | |
type: string | |
content_type: | |
type: string | |
failure_code: | |
$ref: '#/components/schemas/FailureCode' | |
failure_message: | |
$ref: '#/components/schemas/FailureMessage' | |
idempotency_id: | |
type: string | |
description: A randomly generated value that gets tied with the request. | |
nullable: true | |
is_void: | |
type: boolean | |
description: Details if the `Authorization` is void. | |
merchant: | |
type: string | |
description: The ID of the `Merchant` resource the `Authorization` was created under. | |
example: MUxxxxxxxxxxxxxxxxx | |
merchant_identity: | |
type: string | |
description: The ID of `Identity` resource used by the `Merchant` the `Authorization` was created under. | |
example: IDxxxxxxxxxxxxxxxxx | |
messages: | |
type: array | |
description: Message field that provides additional details. This field is typically **null**. | |
items: | |
type: string | |
raw: | |
$ref: '#/components/schemas/Raw' | |
source: | |
type: string | |
example: PIxxxxxxxxxxxxxxxxxx | |
description: ID of the `Payment Instrument` where funds get debited. | |
state: | |
type: string | |
enum: | |
- CANCELED | |
- PENDING | |
- FAILED | |
- SUCCEEDED | |
- UNKNOWN | |
description: The state of the `Transfer`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
trace_id: | |
type: string | |
description: Trace ID of the `Authorization`. The processor sends back the `trace_id` so you can track the authorization end-to-end. | |
transfer: | |
type: string | |
example: TRxxxxxxxxxxxxxxxxxx | |
description: The ID of the `transfer` resource that gets created when the `Authorization` moves to **SUCCEEDED**. | |
nullable: true | |
void_state: | |
type: string | |
description: Details if the `Authorization` has been voided. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
device: | |
type: object | |
description: Link to the `Device` the request was made under. | |
properties: | |
href: | |
type: string | |
merchant_identity: | |
type: object | |
description: Link to the `Identity` the `Merchant` was created under and the `Transfer` was submitted with. | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfer: | |
type: object | |
description: Link to the `Transfers` realted to the `Authorization`. | |
properties: | |
href: | |
type: string | |
AuthorizationsList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `Authroization` objects. | |
properties: | |
authorizations: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Authorization` objects.' | |
items: | |
$ref: '#/components/schemas/Authorization' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
CreateDevice: | |
type: object | |
title: CreateDevice | |
description: '' | |
properties: | |
configuration: | |
$ref: '#/components/schemas/ConfigurationDetails' | |
description: | |
type: string | |
description: Additional information about device (e.g. self serving terminal). | |
model: | |
type: string | |
enum: | |
- BBPOS | |
- DESK_3500 | |
- DESK_5000 | |
- IPP320 | |
- IPP350 | |
- ISC250 | |
- ISC480 | |
- ISMP4 | |
- LANE_3000 | |
- LANE_5000 | |
- LANE_7000 | |
- LANE_8000 | |
- LINK_2500 | |
- MOVE_5000 | |
- MX915 | |
- MX925 | |
- PAX_A30 | |
- PAX_A35 | |
- PAX_A60 | |
- PAX_A77 | |
- PAX_A920PRO | |
- PAX_ARIES6 | |
- PAX_ARIES8 | |
- PAX_IM30 | |
description: The model type of the device. | |
name: | |
type: string | |
description: Name of the `Device`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- model | |
- name | |
x-examples: | |
example-1: | |
name: 'Finix triPOS #1' | |
model: MX915 | |
description: John Smith | |
configuration: | |
allow_debit: true | |
prompt_signature: NEVER | |
bypass_device_on_capture: true | |
Currency: | |
type: string | |
description: ISO 4217 3 letter currency code. | |
enum: | |
- AED | |
- AFN | |
- ALL | |
- AMD | |
- ANG | |
- AOA | |
- ARS | |
- AUD | |
- AWG | |
- AZN | |
- BAM | |
- BBD | |
- BDT | |
- BGN | |
- BHD | |
- BIF | |
- BMD | |
- BND | |
- BOB | |
- BOV | |
- BRL | |
- BSD | |
- BTN | |
- BWP | |
- BYR | |
- BZD | |
- CAD | |
- CDF | |
- CHE | |
- CHF | |
- CHW | |
- CLF | |
- CLP | |
- CNY | |
- COP | |
- COU | |
- CRC | |
- CUC | |
- CUP | |
- CVE | |
- CZK | |
- DJF | |
- DKK | |
- DOP | |
- DZD | |
- EGP | |
- ERN | |
- ETB | |
- EUR | |
- FJD | |
- FKP | |
- GBP | |
- GEL | |
- GHS | |
- GIP | |
- GMD | |
- GNF | |
- GTQ | |
- GYD | |
- HKD | |
- HNL | |
- HRK | |
- HTG | |
- HUF | |
- IDR | |
- ILS | |
- INR | |
- IQD | |
- IRR | |
- ISK | |
- JMD | |
- JOD | |
- JPY | |
- KES | |
- KGS | |
- KHR | |
- KMF | |
- KPW | |
- KRW | |
- KWD | |
- KYD | |
- KZT | |
- LAK | |
- LBP | |
- LKR | |
- LRD | |
- LSL | |
- LTL | |
- LYD | |
- MAD | |
- MDL | |
- MGA | |
- MKD | |
- MMK | |
- MNT | |
- MOP | |
- MRO | |
- MUR | |
- MVR | |
- MWK | |
- MXN | |
- MXV | |
- MYR | |
- MZN | |
- NAD | |
- NGN | |
- NIO | |
- NOK | |
- NPR | |
- NZD | |
- OMR | |
- PAB | |
- PEN | |
- PGK | |
- PHP | |
- PKR | |
- PLN | |
- PYG | |
- QAR | |
- RON | |
- RSD | |
- RUB | |
- RWF | |
- SAR | |
- SBD | |
- SCR | |
- SDG | |
- SEK | |
- SGD | |
- SHP | |
- SLL | |
- SOS | |
- SRD | |
- SSP | |
- STD | |
- SVC | |
- SYP | |
- SZL | |
- THB | |
- TJS | |
- TMT | |
- TND | |
- TOP | |
- TRY | |
- TTD | |
- TWD | |
- TZS | |
- UAH | |
- UGX | |
- USD | |
- USN | |
- UYI | |
- UYU | |
- UZS | |
- VEF | |
- VND | |
- VUV | |
- WST | |
- XAF | |
- XAG | |
- XAU | |
- XBA | |
- XBB | |
- XBC | |
- XBD | |
- XCD | |
- XDR | |
- XOF | |
- XPD | |
- XPF | |
- XPT | |
- XSU | |
- XTS | |
- XUA | |
- XXX | |
- YER | |
- ZAR | |
- ZMW | |
- ZWL | |
Device: | |
type: object | |
title: Device | |
description: '`Device` resource.' | |
properties: | |
id: | |
type: string | |
description: The ID of the activated `Device`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
configuration_details: | |
type: object | |
title: DeviceConfigDetails | |
description: Information used to configure how the `Device` handles transactions. | |
nullable: true | |
properties: | |
allow_debit: | |
type: boolean | |
description: 'Allow transaction to be processed on Debit rails. If **false**, Debit card transactions will be processed on Credit rails.' | |
bypass_device_on_capture: | |
type: boolean | |
description: Sets whether or not the device will be used to capture transactions. This field must be set to **true** (defaults to **false**). | |
nullable: true | |
check_for_duplicate_transactions: | |
type: boolean | |
description: Sets whether the `Device` will check for duplicate transactions. | |
prompt_amount_confirmation: | |
type: boolean | |
description: Sets if the card holder needs to confirm the amount they will pay (defaults to **true**). | |
prompt_manual_entry: | |
type: boolean | |
description: Sets if the device defaults to manual entry as the default card input method. (defaults to **false**). | |
prompt_signature: | |
type: string | |
description: 'Sets if the device will prompt the card holder for a signature by default. Available values include: <ul><li><strong>ALWAYS</strong><li><strong>NEVER</strong><li><strong>AMOUNT</strong>: Used in conjunction with `signature_threshold_amount` so when the threshold is reached the signature form appears on the device.' | |
signature_threshold_amount: | |
type: integer | |
format: int64 | |
description: The threshold to prompt a signature when `prompt_signature` is set to **AMOUNT** (defaults to 0). | |
connection: | |
type: string | |
description: Details if the `Device` is connected and online. Only returned when `include_connection parameter` provided. | |
enum: | |
- OPEN | |
- CLOSED | |
description: | |
type: string | |
description: Additional information about device (e.g. self serving terminal). | |
nullable: true | |
enabled: | |
type: boolean | |
description: Details if the `Device` resource is enabled. Set to **false** to disable the `Device`. | |
idle_message: | |
type: string | |
description: The message that diplays on the device after a period of inactivity. | |
nullable: true | |
merchant: | |
type: string | |
example: MUxxxxxxxxxxxxxxxxxx | |
description: ID of the `Merchant` resource. | |
model: | |
type: string | |
description: Details the model of the card reader. | |
name: | |
type: string | |
description: Name of the `Device`. | |
serial_number: | |
type: string | |
description: Serial number of the device. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
authorizations: | |
type: object | |
properties: | |
href: | |
type: string | |
merchant: | |
type: object | |
description: Link to the `Merhcant` resource that was used in the request. | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
properties: | |
href: | |
type: string | |
Dispute: | |
type: object | |
title: Dispute | |
description: A `Dispute` objected created for a chargeback or customer disputes. | |
properties: | |
id: | |
type: string | |
example: DIxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Dispute` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
action: | |
type: string | |
description: The next `action` required to move forward with the `Dispute`. | |
nullable: true | |
amount: | |
type: integer | |
description: The total amount of the `Dispute` (in cents). | |
nullable: true | |
application: | |
type: string | |
description: The ID of the `Application` resource that the `Dispute` was created under. | |
dispute_details: | |
description: Details about the `Dispute` received by the `Processor`. Any data from the processor can get included. | |
type: object | |
properties: | |
case_id: | |
type: string | |
description: The case number the `Processor` has given the dispute in their internal database. | |
nullable: true | |
pin_debit_adjustment_number: | |
type: string | |
description: Used by the processor to identify the funds that are getting disputed. | |
nullable: true | |
reason_code: | |
type: string | |
description: Used by the processor and card networks to identify why the dispute got filed. | |
nullable: true | |
evidence_submitted: | |
type: string | |
enum: | |
- CHARGEBACK | |
- NOT_SUPPORTED | |
- NONE | |
- UNKNOWN | |
- INQUIRY | |
description: 'The status of the uploaded evidence. [See `Dispute#response_details` for the next steps to move the `Dispute` forward](/api/tag/Disputes/#tag/Disputes/operation/getDispute!c=200&path=response_state&t=response).' | |
identity: | |
type: string | |
description: |- | |
- The ID of the seller's `Identity` resource. | |
- This is the `Identity` resource that was used to create the seller's `Merchant`. | |
merchant: | |
type: string | |
description: |- | |
- The ID of the seller's `Merchant` resource. | |
- This is the `Merchant` account the `Dispute` was filed against. | |
message: | |
type: string | |
description: Message field that provides additional details. This field is typically **null**. | |
nullable: true | |
occurred_at: | |
type: string | |
description: Point in time when the `Transfer` that's getting disputed got created. | |
format: date-time | |
nullable: true | |
reason: | |
type: string | |
enum: | |
- CLERICAL | |
- FRAUD | |
- INQUIRY | |
- QUALITY | |
- TECHNICAL | |
description: 'The system-defined reason for the `Dispute`. Available values include:<ul><li>**INQUIRY**<li>**QUALITY**<li>**FRAUD**' | |
respond_by: | |
type: string | |
format: date-time | |
description: 'Point in time, the `Merchant` needs to respond to the dispute by.' | |
nullable: true | |
response_state: | |
type: string | |
enum: | |
- NEEDS_RESPONSE | |
- RESPONDED | |
- ACCEPTED | |
- NO_RESPONSE_ALLOWED | |
- UNKNOWN | |
description: |- | |
Details the state of the `Dispute` and what action the `Merchant` needs to take. | |
- **NEEDS_RESPONSE**: The `Merchant` needs to respond to the `Dispute` by `Dispute#respond_by`. For details on how to respond to a `Dispute`, see [Responding to Disputes](/guides/after-the-payment/disputes/responding-disputes/). | |
- **RESPONDED**: The issuing bank has received the evidence and actively reviewing it. No action needed from the `Merchant`. | |
- **ACCEPTED**: The `Merchant` has accepted the `Dispute`. When a `Dispute` is accepted, you concede that the dispute is not worth challenging or representing. For details on how to accept a `Dispute`, see [Accepting a Dispute](/guides/after-the-payment/disputes/accepting-disputes/). | |
- **NO_RESPONSE_ALLOWED**: The final `Dispute#response_state` when a `Dispute` is either **WON** or **LOST**. | |
- **UNKNOWN**: `Dispute` details couldn't be submitted to the processor. Comes up when testing `Disputes` in sandbox or on the **DUMMY_V1** processor. | |
state: | |
type: string | |
enum: | |
- INQUIRY | |
- PENDING | |
- WON | |
- LOST | |
description: The current state of the `Dispute`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
transfer: | |
type: string | |
description: ID of the `Transfer` resource. | |
example: TRxxxxxxxxxxxxxxxxxx | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
adjustment_transfers: | |
type: object | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
evidence: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfer: | |
type: object | |
description: Link to the `Transfers` realted to the `Dispute`. | |
properties: | |
href: | |
type: string | |
DisputeEvidence: | |
type: object | |
properties: | |
id: | |
type: string | |
example: DFxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Dispute` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
example: APgPDQrLD52TYvqazjHJJchM | |
description: The ID of the `Application` resource that the `Dispute` was created under. | |
dispute: | |
type: string | |
description: The ID of the `Dispute` associated with the evidence. | |
state: | |
type: string | |
enum: | |
- PENDING | |
- SUCCEEDED | |
- CANCELED | |
- FAILED | |
description: |- | |
Result of the evidence uploaded. | |
- **PENDING**: The evidence file has not yet been submitted to the Processor. No user action is required. | |
- **SUCCEEDED**: The evidence file has been successfully sent to the Processor. No further user action is required. | |
- **CANCELED**: The evidence file upload was not completed due to user action. | |
- **FAILED**: An issue occurred. User action is required**. Any of the following issues could have occurred: | |
- There was an error in the system and the user should retry uploading their evidence file. | |
- There is an issue with the file and the user should retry uploading a different file. | |
- There is an issue and the user should contact Support. | |
identity: | |
type: string | |
example: IDpYDM7J9n57q849o9E9yNrG | |
description: |- | |
- The ID of the seller's `Identity` resource. | |
- This is the `Identity` resource that was used to create the seller's `Merchant`. | |
merchant: | |
type: string | |
example: MUucec6fHeaWo3VHYoSkUySM | |
description: |- | |
- The ID of the seller's `Merchant` resource. | |
- This is the `Merchant` account the `Dispute` was filed against. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
CreateDisputeEvidenceRequest: | |
type: object | |
properties: | |
file: | |
type: string | |
format: binary | |
description: The binary contents of the file. | |
DisputeEvidenceList: | |
type: object | |
title: '' | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `evidence` created for a `Dispute`. | |
properties: | |
evidences: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Evidence` objects.' | |
items: | |
$ref: '#/components/schemas/DisputeEvidence' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
DisputesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageOffset' | |
_embedded: | |
type: object | |
description: List of `Dispute` objects. | |
properties: | |
disputes: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Dispute` objects.' | |
items: | |
$ref: '#/components/schemas/Dispute' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
Error401Unauthorized: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- UNKNOWN | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
additionalProperties: true | |
properties: | |
self: | |
type: object | |
properties: | |
href: | |
type: string | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
Error402PaymentRequired: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- CALL_ISSUER | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
enum: | |
- Please contact card issuer for more information. | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
Error403ForbiddenList: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- FORBIDDEN | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
description: '' | |
title: '' | |
ErrorGeneric: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- FORBIDDEN | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
Error404NotFoundList: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- NOT_FOUND | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
Error406NotAcceptable: | |
type: object | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
additionalProperties: true | |
properties: | |
code: | |
type: string | |
enum: | |
- NOT_FOUND | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
title: '' | |
Error422InvalidFieldList: | |
type: object | |
description: Invalid field | |
title: '' | |
properties: | |
total: | |
type: integer | |
_embedded: | |
type: object | |
properties: | |
errors: | |
type: array | |
items: | |
type: object | |
properties: | |
code: | |
type: string | |
enum: | |
- INVALID_FIELD | |
field: | |
type: string | |
logref: | |
$ref: '#/components/schemas/LogRef' | |
message: | |
type: string | |
_links: | |
type: object | |
properties: | |
source: | |
type: object | |
properties: | |
href: | |
type: string | |
Fee: | |
type: object | |
title: Fee | |
description: An out of flow `fee` that is added to a `settlement`. | |
properties: | |
id: | |
type: string | |
example: FExxxxxxxxxxxxxxxxxx | |
description: The ID of the `fee` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
amount: | |
type: integer | |
description: The amount of the fee in cents. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
display_name: | |
type: string | |
description: The name of the `fee` object that was include in `display_name` when creating the fee. | |
nullable: true | |
fee_subtype: | |
type: string | |
enum: | |
- CUSTOM | |
- APPLICATION_FEE | |
- PLATFORM_FEE | |
description: Subtype of the `fee`. | |
fee_type: | |
type: string | |
enum: | |
- APPLICATION_FEE | |
- ACH_BASIS_POINTS | |
- ACH_FIXED | |
- CARD_BASIS_POINTS | |
- CARD_FIXED | |
- CARD_INTERCHANGE | |
- VISA_BASIS_POINTS | |
- VISA_FIXED | |
- VISA_INTERCHANGE | |
- VISA_ASSESSMENT_BASIS_POINTS | |
- VISA_ACQUIRER_PROCESSING_FIXED | |
- VISA_CREDIT_VOUCHER_FIXED | |
- VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED | |
- VISA_BASE_II_CREDIT_VOUCHER_FIXED | |
- VISA_KILOBYTE_ACCESS_FIXED | |
- DISCOVER_BASIS_POINTS | |
- DISCOVER_FIXED | |
- DISCOVER_INTERCHANGE | |
- DISCOVER_ASSESSMENT_BASIS_POINTS | |
- DISCOVER_DATA_USAGE_FIXED | |
- DISCOVER_NETWORK_AUTHORIZATION_FIXED | |
- DINERS_CLUB_BASIS_POINTS | |
- DINERS_CLUB_FIXED | |
- DINERS_CLUB_INTERCHANGE | |
- MASTERCARD_BASIS_POINTS | |
- MASTERCARD_FIXED | |
- MASTERCARD_INTERCHANGE | |
- MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS | |
- MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS | |
- MASTERCARD_ACQUIRER_FEE_BASIS_POINTS | |
- JCB_BASIS_POINTS | |
- JCB_FIXED | |
- JCB_INTERCHANGE | |
- AMERICAN_EXPRESS_BASIS_POINTS | |
- AMERICAN_EXPRESS_FIXED | |
- AMERICAN_EXPRESS_INTERCHANGE | |
- AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS | |
- DISPUTE_INQUIRY_FIXED_FEE | |
- DISPUTE_FIXED_FEE | |
- QUALIFIED_TIER_BASIS_POINTS_FEE | |
- QUALIFIED_TIER_FIXED_FEE | |
- CUSTOM | |
- ACH_DEBIT_RETURN_FIXED_FEE | |
- ACH_CREDIT_RETURN_FIXED_FEE | |
- ANCILLARY_FIXED_FEE_PRIMARY | |
- ANCILLARY_FIXED_FEE_SECONDARY | |
- SETTLEMENT_V2_TRANSFER | |
description: The type of `fee`. | |
label: | |
type: string | |
description: The name of the `fee` object that was include in `label` when creating the fee. | |
nullable: true | |
linked_id: | |
type: string | |
description: ID of the linked resource. | |
linked_type: | |
type: string | |
enum: | |
- APPLICATION | |
- PLATFORM | |
- SUBSCRIPTION | |
- TRANSFER | |
description: The type of entity the `fee` is linked to (**null** by default). | |
merchant: | |
type: string | |
description: The `Merchant` ID that the fee is being debited from. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
merchant: | |
type: object | |
description: Link to the `Merhcant` resource that was used in the request. | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfer: | |
type: object | |
description: Link to the `Transfers` realted to the `Dispute`. | |
properties: | |
href: | |
type: string | |
CreateFeeRequest: | |
type: object | |
title: '' | |
properties: | |
amount: | |
$ref: '#/components/schemas/Amount' | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fee_subtype: | |
type: string | |
enum: | |
- CUSTOM | |
description: Subtype of the fee. Set to **CUSTOM**. | |
fee_type: | |
type: string | |
enum: | |
- CUSTOM | |
description: The type of the fee. Must be set to **CUSTOM**. | |
label: | |
type: string | |
description: The display name of the `Fee` that can be used for filtering purposes. | |
linked_id: | |
type: string | |
description: ID of the linked resource | |
linked_type: | |
type: string | |
enum: | |
- APPLICATION | |
- PLATFORM | |
- SUBSCRIPTION | |
- TRANSFER | |
description: The type of entity the fee is linked to (**null** by default). | |
merchant_id: | |
type: string | |
description: The ID of the `Merchant` resource used to create the `Fee`. | |
settlement_delay_days: | |
type: integer | |
description: 'Delays in days, when the `Transfer` the `Fee` creates will be submitted for settlement.' | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- amount | |
- currency | |
- fee_subtype | |
- fee_type | |
- merchant_id | |
FeeProfile: | |
type: object | |
properties: | |
id: | |
type: string | |
example: FPxxxxxxxxxxxxxxxxxx | |
description: The ID of the `Fee Profile` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
ach_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of an eCheck (also called ACH payments). Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
ach_credit_return_fixed_fee: | |
type: integer | |
description: A fixed amount in cents that will be charged to the seller for processing an echeck (also called ACH payments) credit return. | |
nullable: true | |
ach_debit_return_fixed_fee: | |
type: integer | |
description: A fixed amount in cents that will be charged to the seller for processing an echeck (also called ACH payment) debit return. | |
nullable: true | |
ach_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual `Transfer`. | |
american_express_assessment_basis_points: | |
type: integer | |
description: Applies to gross American Express card volume. | |
nullable: true | |
american_express_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each American Express `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
american_express_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for American Express `Transfers`. | |
nullable: true | |
american_express_externally_funded_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each American Express externally funded `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
american_express_externally_funded_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual American Express externally funded `Transfer`. | |
nullable: true | |
american_express_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual American Express `Transfer`. | |
nullable: true | |
ancillary_fixed_fee_primary: | |
type: integer | |
description: An additional fixed fee that can be charged per `Transfer`. | |
nullable: true | |
ancillary_fixed_fee_secondary: | |
type: integer | |
description: An additional fixed fee that can be charged per `Transfer` if `ancillary_fixed_fee_primary` is included. | |
nullable: true | |
application: | |
type: string | |
description: The ID of the `Application` associated with the `Fee Profile`. | |
basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each card-based `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
card_cross_border_basis_points: | |
type: integer | |
description: Percentage-based fee charged against the full amount of every `Transfer` that includes non-US cards. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%). | |
nullable: true | |
card_cross_border_fixed_fee: | |
type: integer | |
description: Fee in cents charged against every `Transfer` that includes non-US cards. | |
nullable: true | |
charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for card-based `Transfers`. | |
diners_club_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each Diners `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%). | |
nullable: true | |
diners_club_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for Diners `Transfers`. | |
nullable: true | |
diners_club_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual Diners `Transfer`. | |
nullable: true | |
discover_assessments_basis_points: | |
type: integer | |
description: Assessment applies to gross Discover card transaction volume. | |
nullable: true | |
discover_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each Discover `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
discover_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for Discover `Transfers`. | |
nullable: true | |
discover_data_usage_fixed_fee: | |
type: integer | |
description: Applies to all U.S.-based `authorization` transactions. | |
nullable: true | |
discover_externally_funded_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each Discover externally funded `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%). | |
nullable: true | |
discover_externally_funded_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual Discover externally funded `Transfer`. | |
nullable: true | |
discover_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual Discover `Transfer`. | |
nullable: true | |
discover_network_authorization_fixed_fee: | |
type: integer | |
description: This fee applies to all Discover network `authorizations` and replaces the previously assessed Data Transmission. | |
nullable: true | |
dispute_fixed_fee: | |
type: integer | |
description: Applied when a `dispute` is created or updated to a **PENDING** state. | |
nullable: true | |
dispute_inquiry_fixed_fee: | |
type: integer | |
description: Applied when a `dispute` is created or updated to a **INQUIRY** state. | |
nullable: true | |
externally_funded_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each `Transfer` that's card-based and externally funded. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%). | |
nullable: true | |
externally_funded_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual `Transfer` that's card-based and externally funded. | |
nullable: true | |
fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual card-based `Transfer`. | |
jcb_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each JCB `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
jcb_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for JCB Transfers. | |
nullable: true | |
jcb_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual JCB `Transfer`. | |
nullable: true | |
mastercard_acquirer_fees_basis_points: | |
type: integer | |
description: 'The fee is assessed on a business’s gross MasterCard processing volume. This fee varies per acquirer based on MasterCard’s assessed charge as it’s distributed across the acquirer’s portfolio of merchants. Generally, this fee is a fraction of a basis point. For example, 0.0045%, 0.0075%, etc. are examples of a likely fee.' | |
nullable: true | |
mastercard_assessments_over1k_basis_points: | |
type: integer | |
description: 'Fee applied to Mastercard credit sale transactions greater than $1,000.' | |
nullable: true | |
mastercard_assessments_under1k_basis_points: | |
type: integer | |
description: 'Fee applied to Mastercard transactions less than or equal to $1,000.' | |
nullable: true | |
mastercard_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each MasterCard `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
mastercard_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for MasterCard `Transfers`. | |
nullable: true | |
mastercard_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual MasterCard `Transfer`. | |
nullable: true | |
qualified_tiers: | |
type: object | |
description: The top of the qualified tier tree. | |
nullable: true | |
rounding_mode: | |
type: string | |
enum: | |
- TRANSACTION | |
- AGGREGATE | |
description: '<ul><li>Include <strong>AGGREGATE</strong> if you want to round after the settlement calculation.<li>By default, rounding happens before the sum of the settlement calculation (i.e. round each fee transfer)</ul>' | |
visa_acquirer_processing_fixed_fee: | |
type: integer | |
description: 'Applied to all U.S.-based credit card authorizations acquired in the U.S. regardless of where the issuer/cardholder is located. If your business is based in the U.S., the acquirer processing fee will apply to all Visa credit card authorizations' | |
nullable: true | |
visa_assessments_basis_points: | |
type: integer | |
description: Applies to all Visa credit transactions. | |
nullable: true | |
visa_base_II_credit_voucher_fixed_fee: | |
type: integer | |
description: Applies to all U.S.-based refunds. | |
nullable: true | |
visa_base_II_system_file_transmission_fixed_fee: | |
type: integer | |
description: Applies to all Visa transactions and is charged in addition to other transaction-based assessments. | |
nullable: true | |
visa_basis_points: | |
type: integer | |
description: Percentage-based fee incurred against the full amount of each Visa `Transfer`. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%) | |
nullable: true | |
visa_charge_interchange: | |
type: boolean | |
description: Set to **True** to incur interchange fees for Visa `Transfers`. | |
nullable: true | |
visa_credit_voucher_fixed_fee: | |
type: integer | |
description: Applies to Visa refunds. | |
nullable: true | |
visa_fixed_fee: | |
type: integer | |
description: Fee in cents incurred for each individual Visa `Transfer`. | |
nullable: true | |
visa_kilobyte_access_fixed_fee: | |
type: integer | |
description: Charged on each authorization transaction submitted to Visa’s network for settlement. | |
nullable: true | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
owner_identity: | |
type: object | |
properties: | |
href: | |
type: string | |
processors: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
users: | |
type: object | |
properties: | |
href: | |
type: string | |
FeeProfilesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `fee_profile` objects. | |
properties: | |
fee_profiles: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`fee_profile` objects.' | |
items: | |
$ref: '#/components/schemas/FeeProfile' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
UpdateFeeRequest: | |
type: object | |
description: '' | |
properties: | |
tags: | |
type: object | |
description: Key value pair for annotating custom meta data (e.g. order numbers). | |
nullable: true | |
FeesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageOffset' | |
_embedded: | |
type: object | |
description: List of `fee` objects. | |
properties: | |
fees: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`fee` objects.' | |
items: | |
$ref: '#/components/schemas/Fee' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
IdentitiesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `Identity` resources. | |
properties: | |
identities: | |
type: array | |
uniqueItems: true | |
description: An `Identity` resource represents either a person or business in Finix. | |
items: | |
$ref: '#/components/schemas/Identity' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
Identity: | |
anyOf: | |
- title: Identity - Merchant | |
properties: | |
id: | |
type: string | |
minLength: 1 | |
description: The ID of the `Identity` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
additional_underwriting_data: | |
type: object | |
description: Additional underwriting data that's required to verify the `Identity`. | |
nullable: true | |
properties: | |
annual_ach_volume: | |
type: integer | |
description: The approximate annual ACH sales expected to be processed (in cents) by this seller (max 10 characters). | |
average_ach_transfer_amount: | |
type: integer | |
description: The approximate average ACH sale amount (in cents) for this seller. | |
average_card_transfer_amount: | |
type: integer | |
description: The average credit card sale amount (in cents) for this seller. | |
business_description: | |
type: string | |
minLength: 1 | |
description: Description of this merchant's business (max 200 characters). | |
card_volume_distribution: | |
type: object | |
description: The distribution of the merchant's credit card volume The sum of `card_volume_distribution` must be 100. | |
nullable: true | |
properties: | |
card_present_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's card present (between 0 and 100). | |
ecommerce_percentage: | |
type: integer | |
description: The percentage of the merchant's business that is eCommerce (between 0 and 100). | |
mail_order_telephone_order_percentage: | |
type: integer | |
description: The percentage of the merchant's business that is a mail or telephone order (between 0 and 100). | |
credit_check_allowed: | |
type: boolean | |
description: Sets if this merchant has consented and accepted to a credit check. | |
credit_check_ip_address: | |
type: string | |
minLength: 1 | |
description: 'The IP address of the merchant when they consented to a credit check (e.g., 42.1.1.113 ).' | |
credit_check_timestamp: | |
type: string | |
minLength: 1 | |
description: 'A timestamp of when this merchant consented to a credit check (e.g., 2021-04-28T16:42:55Z).' | |
credit_check_user_agent: | |
type: string | |
minLength: 1 | |
description: 'The details of the browser that was used when this merchant consented to a credit check (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
merchant_agreement_accepted: | |
type: boolean | |
description: Sets whether this merchant has accepted the terms and conditions of the merchant agreement. | |
merchant_agreement_ip_address: | |
type: string | |
minLength: 1 | |
description: 'IP address of the merchant when this merchant accepted the merchant agreement (e.g., 42.1.1.113).' | |
merchant_agreement_timestamp: | |
type: string | |
minLength: 1 | |
description: 'Timestamp of when the merchant accepted Finix''s Terms of Service (e.g., 2021-04-28T16:42:55Z).' | |
merchant_agreement_user_agent: | |
type: string | |
minLength: 1 | |
description: 'The details of the browser that was used when this merchant accepted Finix''s Terms of Service (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
refund_policy: | |
type: string | |
minLength: 1 | |
description: Include the value that best applies to the seller's refund policy. | |
enum: | |
- NO_REFUNDS | |
- MERCHANDISE_EXCHANGE_ONLY | |
- WITHIN_30_DAYS | |
- OTHER | |
volume_distribution_by_business_type: | |
type: object | |
description: Merchant's distribution of credit card volume by business type. Sum of `volume_distribution_by_business_type` must be 100. | |
nullable: true | |
properties: | |
business_to_business_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to business (between 0 and 100). | |
business_to_consumer_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to consumer (between 0 and 100). | |
consumer_to_consumer_volume_percentage: | |
type: integer | |
description: Merchant's percentage of volume that is consumer to consumer (between 0 and 100). | |
other_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that isn't represented by the previous fields (between 0 and 100). | |
person_to_person_volume_percentage: | |
type: integer | |
description: The percentage the merchant's volume that's person to person (between 0 and 100). | |
application: | |
type: string | |
minLength: 1 | |
description: ID of the `Application` associated with the `Identity`. | |
entity: | |
type: object | |
description: The underwriting details required to verify the `Identity`. | |
properties: | |
amex_mid: | |
type: integer | |
description: 'Assigned amexMid value. If a value is passed, it must be 10 or 11 digits.' | |
nullable: true | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed by this merchant (max 19 characters). | |
nullable: true | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
nullable: true | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If <strong>INDIVIDUAL_SOLE_PROPRIETORSHIP</strong>, pass the owner''s legal first name, last name and middle initial.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
nullable: true | |
business_tax_id_provided: | |
type: boolean | |
description: Details if the `business_tax_id` was provided. | |
business_type: | |
description: Include the value that best applies to the merchant. | |
type: string | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
nullable: true | |
discover_mid: | |
description: Assigned discoverMid value. | |
type: integer | |
nullable: true | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
minimum: 1 | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
minimum: 1 | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900. | |
minimum: 1900 | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
nullable: true | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
nullable: true | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
nullable: true | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The legal last name of the merchant's control owner (max 20 characters). | |
nullable: true | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
nullable: true | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the merchant's principal control owner. This field is used for identity verification purposes. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
nullable: true | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
nullable: true | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
nullable: true | |
short_business_name: | |
type: string | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
tax_authority: | |
type: string | |
description: <ul><li>Only required when onboarding a merchant with a <tt>MCC</tt> of <strong>9311</strong>.<li> The <tt>tax_authority</tt> is the tax gathering entity (e.g San Francisco Water Authority). | |
nullable: true | |
tax_id_provided: | |
type: boolean | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the merchant's public website. | |
nullable: true | |
identity_roles: | |
$ref: '#/components/schemas/IdentityRoles' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
merchants: | |
type: object | |
description: Link to the `Merchant` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
settlements: | |
type: object | |
description: Link to the `Settlement` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
authorizations: | |
type: object | |
description: Link to the `Authorization` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
transfers: | |
type: object | |
description: Link to the `Transfer` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
payment_instruments: | |
type: object | |
description: Link to the `Payment Instrume` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
associated_identities: | |
type: object | |
description: Link to any other `Identites` associated with the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
disputes: | |
type: object | |
description: Link to the `Dispute` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
- title: Identity - Buyer | |
properties: | |
id: | |
type: string | |
minLength: 1 | |
description: The ID of the `Identity` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
application: | |
type: string | |
minLength: 1 | |
description: ID of the `Application` associated with the `Identity`. | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
entity: | |
type: object | |
description: The underwriting details required to verify the `Identity`. | |
properties: | |
amex_mid: | |
type: integer | |
description: 'Assigned amexMid value. If a value is passed, it must be 10 or 11 digits.' | |
nullable: true | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed by this merchant (max 19 characters). | |
nullable: true | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
nullable: true | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If <strong>INDIVIDUAL_SOLE_PROPRIETORSHIP</strong>, pass the owner''s legal first name, last name and middle initial.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
nullable: true | |
business_tax_id_provided: | |
type: boolean | |
description: Details if the `business_tax_id` was provided. | |
business_type: | |
description: Include the value that best applies to the merchant. | |
type: string | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
nullable: true | |
discover_mid: | |
description: Assigned discoverMid value. | |
type: integer | |
nullable: true | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
minimum: 1 | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
minimum: 1 | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900. | |
minimum: 1900 | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
nullable: true | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
nullable: true | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
nullable: true | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The legal last name of the merchant's control owner (max 20 characters). | |
nullable: true | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
nullable: true | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the merchant's principal control owner. This field is used for identity verification purposes. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
nullable: true | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
nullable: true | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
nullable: true | |
short_business_name: | |
type: string | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
tax_authority: | |
type: string | |
description: <ul><li>Only required when onboarding a merchant with a <tt>MCC</tt> of <strong>9311</strong>.<li> The <tt>tax_authority</tt> is the tax gathering entity (e.g San Francisco Water Authority). | |
nullable: true | |
tax_id_provided: | |
type: boolean | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the merchant's public website. | |
nullable: true | |
identity_roles: | |
$ref: '#/components/schemas/IdentityRoles' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
merchants: | |
type: object | |
description: Link to the `Merchant` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
settlements: | |
type: object | |
description: Link to the `Settlement` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
authorizations: | |
type: object | |
description: Link to the `Authorization` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
transfers: | |
type: object | |
description: Link to the `Transfer` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
payment_instruments: | |
type: object | |
description: Link to the `Payment Instrume` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
associated_identities: | |
type: object | |
description: Link to any other `Identites` associated with the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
disputes: | |
type: object | |
description: Link to the `Dispute` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
- title: Associated Identity | |
properties: | |
id: | |
type: string | |
minLength: 1 | |
description: The ID of the `Identity` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
application: | |
type: string | |
minLength: 1 | |
description: ID of the `Application` associated with the `Identity`. | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
entity: | |
type: object | |
description: The underwriting details required to verify the `Identity`. | |
properties: | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed by this merchant (max 19 characters). | |
nullable: true | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
nullable: true | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If <strong>INDIVIDUAL_SOLE_PROPRIETORSHIP</strong>, pass the owner''s legal first name, last name and middle initial.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
nullable: true | |
business_tax_id_provided: | |
type: boolean | |
description: Details if the `business_tax_id` was provided. | |
business_type: | |
description: Include the value that best applies to the merchant. | |
type: string | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
nullable: true | |
discover_mid: | |
description: Assigned discoverMid value. | |
type: integer | |
nullable: true | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
minimum: 1 | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
minimum: 1 | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900. | |
minimum: 1900 | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
nullable: true | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
nullable: true | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
nullable: true | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The legal last name of the merchant's control owner (max 20 characters). | |
nullable: true | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
nullable: true | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the merchant's principal control owner. This field is used for identity verification purposes. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
nullable: true | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
nullable: true | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
nullable: true | |
short_business_name: | |
type: string | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
tax_authority: | |
type: string | |
description: <ul><li>Only required when onboarding a merchant with a <tt>MCC</tt> of <strong>9311</strong>.<li> The <tt>tax_authority</tt> is the tax gathering entity (e.g San Francisco Water Authority). | |
nullable: true | |
tax_id_provided: | |
type: boolean | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the merchant's public website. | |
nullable: true | |
identity_roles: | |
$ref: '#/components/schemas/IdentityRoles' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
merchants: | |
type: object | |
description: Link to the `Merchant` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
settlements: | |
type: object | |
description: Link to the `Settlement` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
authorizations: | |
type: object | |
description: Link to the `Authorization` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
transfers: | |
type: object | |
description: Link to the `Transfer` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
payment_instruments: | |
type: object | |
description: Link to the `Payment Instrume` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
associated_identities: | |
type: object | |
description: Link to any other `Identites` associated with the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
disputes: | |
type: object | |
description: Link to the `Dispute` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
type: object | |
AssociatedIdentity: | |
description: '' | |
x-examples: | |
example-1: | |
id: IDpYDM7J9n57q849o9E9yNrG | |
application: APgPDQrLD52TYvqazjHJJchM | |
entity: | |
title: CEO | |
first_name: dwayne | |
last_name: Sunkhronos | |
email: user@example.org | |
business_name: Petes Coffee | |
business_type: INDIVIDUAL_SOLE_PROPRIETORSHIP | |
doing_business_as: Petes Coffee | |
phone: '14158885080' | |
business_phone: +1 (408) 756-4497 | |
personal_address: | |
line1: 741 Douglass St | |
line2: Apartment 7 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
business_address: | |
line1: 741 Douglass St | |
line2: Apartment 8 | |
city: San Mateo | |
region: CA | |
postal_code: '94114' | |
country: USA | |
mcc: '4900' | |
dob: | |
day: 27 | |
month: 6 | |
year: 1978 | |
max_transaction_amount: 12000000 | |
amex_mid: null | |
discover_mid: null | |
url: www.PetesCoffee.com | |
annual_card_volume: 12000000 | |
has_accepted_credit_cards_previously: true | |
incorporation_date: | |
day: 27 | |
month: 6 | |
year: 1978 | |
principal_percentage_ownership: 50 | |
short_business_name: null | |
ownership_type: PRIVATE | |
tax_authority: null | |
tax_id_provided: true | |
business_tax_id_provided: true | |
default_statement_descriptor: Petes Coffee | |
tags: | |
Studio Rating: '4.7' | |
created_at: '2022-01-27T07:36:52.11Z' | |
updated_at: '2022-01-27T07:36:52.00Z' | |
additional_underwriting_data: | |
annual_ach_volume: 200000 | |
average_ach_transfer_amount: 200000 | |
average_card_transfer_amount: 200000 | |
business_description: SB3 vegan cafe | |
card_volume_distribution: | |
card_present_percentage: 30 | |
ecommerce_percentage: 60 | |
mail_order_telephone_order_percentage: 10 | |
credit_check_allowed: true | |
credit_check_ip_address: 42.1.1.113 | |
credit_check_timestamp: '2021-04-28T16:42:55Z' | |
credit_check_user_agent: Mozilla 5.0(Macintosh; IntelMac OS X 10 _14_6) | |
merchant_agreement_accepted: true | |
merchant_agreement_ip_address: 42.1.1.113 | |
merchant_agreement_timestamp: '2021-04-28T16:42:55Z' | |
merchant_agreement_user_agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) | |
refund_policy: MERCHANDISE_EXCHANGE_ONLY | |
volume_distribution_by_business_type: | |
business_to_business_volume_percentage: 100 | |
business_to_consumer_volume_percentage: 0 | |
consumer_to_consumer_volume_percentage: 0 | |
other_volume_percentage: 0 | |
person_to_person_volume_percentage: 0 | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/verifications' | |
merchants: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/merchants' | |
settlements: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/settlements' | |
authorizations: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/authorizations' | |
transfers: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/transfers' | |
payment_instruments: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/payment_instruments' | |
associated_identities: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/associated_identities' | |
disputes: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG/disputes' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
title: '' | |
anyOf: | |
- title: Associated Identity (Merchant) | |
properties: | |
id: | |
type: string | |
minLength: 1 | |
description: The ID of the `Identity` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
minLength: 1 | |
description: ID of the `Application` associated with the `Identity`. | |
entity: | |
type: object | |
description: The underwriting details required to verify the `Identity`. | |
properties: | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
nullable: true | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If <strong>INDIVIDUAL_SOLE_PROPRIETORSHIP</strong>, pass the owner''s legal first name, last name and middle initial.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
nullable: true | |
business_tax_id_provided: | |
type: boolean | |
description: Details if the `business_tax_id` was provided. | |
business_type: | |
description: Include the value that best applies to the merchant. | |
type: string | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
nullable: true | |
discover_mid: | |
description: Assigned discoverMid value. | |
type: integer | |
nullable: true | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
minimum: 1 | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
minimum: 1 | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900. | |
minimum: 1900 | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
nullable: true | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
nullable: true | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
nullable: true | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The legal last name of the merchant's control owner (max 20 characters). | |
nullable: true | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
nullable: true | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the merchant's principal control owner. This field is used for identity verification purposes. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
nullable: true | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
nullable: true | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
nullable: true | |
short_business_name: | |
type: string | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
tax_authority: | |
type: string | |
description: <ul><li>Only required when onboarding a merchant with a <tt>MCC</tt> of <strong>9311</strong>.<li> The <tt>tax_authority</tt> is the tax gathering entity (e.g San Francisco Water Authority). | |
nullable: true | |
tax_id_provided: | |
type: boolean | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the merchant's public website. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
merchants: | |
type: object | |
description: Link to the `Merchant` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
settlements: | |
type: object | |
description: Link to the `Settlement` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
authorizations: | |
type: object | |
description: Link to the `Authorization` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
transfers: | |
type: object | |
description: Link to the `Transfer` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
payment_instruments: | |
type: object | |
description: Link to the `Payment Instrume` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
associated_identities: | |
type: object | |
description: Link to any other `Identites` associated with the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
disputes: | |
type: object | |
description: Link to the `Dispute` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
- title: Associated Identity (Buyer) | |
properties: | |
id: | |
type: string | |
minLength: 1 | |
description: The ID of the `Identity` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
minLength: 1 | |
description: ID of the `Application` associated with the `Identity`. | |
entity: | |
type: object | |
description: The underwriting details required to verify the `Identity`. | |
properties: | |
amex_mid: | |
type: integer | |
description: 'Assigned amexMid value. If a value is passed, it must be 10 or 11 digits.' | |
nullable: true | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed by this merchant (max 19 characters). | |
nullable: true | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
nullable: true | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If <strong>INDIVIDUAL_SOLE_PROPRIETORSHIP</strong>, pass the owner''s legal first name, last name and middle initial.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
nullable: true | |
business_tax_id_provided: | |
type: boolean | |
description: Details if the `business_tax_id` was provided. | |
business_type: | |
description: Include the value that best applies to the merchant. | |
type: string | |
nullable: true | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
nullable: true | |
discover_mid: | |
description: Assigned discoverMid value. | |
type: integer | |
nullable: true | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
minimum: 1 | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
minimum: 1 | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900. | |
minimum: 1900 | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
nullable: true | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
nullable: true | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
nullable: true | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The legal last name of the merchant's control owner (max 20 characters). | |
nullable: true | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
nullable: true | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: 'Values can be either: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses.' | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the merchant's principal control owner. This field is used for identity verification purposes. | |
nullable: true | |
properties: | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
nullable: true | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
nullable: true | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
nullable: true | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
nullable: true | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
nullable: true | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
nullable: true | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
nullable: true | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
nullable: true | |
short_business_name: | |
type: string | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
tax_authority: | |
type: string | |
description: <ul><li>Only required when onboarding a merchant with a <tt>MCC</tt> of <strong>9311</strong>.<li> The <tt>tax_authority</tt> is the tax gathering entity (e.g San Francisco Water Authority). | |
nullable: true | |
tax_id_provided: | |
type: boolean | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
nullable: true | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the merchant's public website. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
merchants: | |
type: object | |
description: Link to the `Merchant` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
settlements: | |
type: object | |
description: Link to the `Settlement` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
authorizations: | |
type: object | |
description: Link to the `Authorization` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
transfers: | |
type: object | |
description: Link to the `Transfer` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
payment_instruments: | |
type: object | |
description: Link to the `Payment Instrume` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
associated_identities: | |
type: object | |
description: Link to any other `Identites` associated with the request. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
disputes: | |
type: object | |
description: Link to the `Dispute` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
minLength: 1 | |
type: object | |
CreateIdentityRequest: | |
anyOf: | |
- title: Identity - Merchant | |
properties: | |
additional_underwriting_data: | |
type: object | |
description: |- | |
- Additional underwriting details required to verify `Identities`. | |
- Required for any `Merchants` onboarded by Finix Flex customers. If you have any questions, please contact [Finix Support](/guides/business/support-at-finix/). | |
nullable: true | |
properties: | |
annual_ach_volume: | |
type: integer | |
description: The approximate annual ACH sales expected to be processed (in cents) by this merchant (max 10 characters). | |
average_ach_transfer_amount: | |
type: integer | |
description: The approximate average ACH sale amount (in cents) for this merchant. | |
average_card_transfer_amount: | |
type: integer | |
description: The average credit card sale amount (in cents) for this merchant. | |
business_description: | |
type: string | |
description: Description of this merchant's business (max 200 characters). | |
card_volume_distribution: | |
type: object | |
description: The distribution of the merchant's credit card volume The sum of `card_volume_distribution` must be 100. | |
properties: | |
card_present_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's card present (between 0 and 100). | |
mail_order_telephone_order_percentage: | |
type: integer | |
description: The percentage of the merchant's business that is a mail order or telephone order (between 0 and 100). | |
ecommerce_percentage: | |
type: integer | |
description: The percentage of the merchant's business that is eCommerce (between 0 and 100). | |
credit_check_allowed: | |
type: boolean | |
description: Sets if this merchant has consented and accepted to a credit check. | |
credit_check_ip_address: | |
type: string | |
description: 'The IP address of the merchant when they consented to a credit check (e.g., 42.1.1.113 ).' | |
minLength: 1 | |
credit_check_timestamp: | |
type: string | |
minLength: 1 | |
description: 'A timestamp of when this merchant consented to a credit check (e.g., 2021-04-28T16:42:55Z).' | |
credit_check_user_agent: | |
type: string | |
minLength: 1 | |
description: 'The details of the browser that was used when this merchant consented to a credit check (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
merchant_agreement_accepted: | |
type: boolean | |
description: Sets whether this merchant has accepted the terms and conditions of the merchant agreement. | |
merchant_agreement_ip_address: | |
type: string | |
description: 'IP address of the merchant when this merchant accepted the merchant agreement (e.g., 42.1.1.113).' | |
minLength: 1 | |
merchant_agreement_timestamp: | |
type: string | |
minLength: 1 | |
description: Sets if this merchant has consented and accepted to a credit check. | |
merchant_agreement_user_agent: | |
type: string | |
description: 'The details of the browser that was used when this merchant accepted Finix''s Terms of Service (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
minLength: 1 | |
refund_policy: | |
type: string | |
description: 'The details of the browser that was used when this merchant consented to a credit check (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
enum: | |
- NO_REFUNDS | |
- MERCHANDISE_EXCHANGE_ONLY | |
- 30_DAYS | |
- OTHER | |
volume_distribution_by_business_type: | |
type: object | |
description: 'IP address of the merchant when this merchant accepted the merchant agreement (e.g., 42.1.1.113).' | |
properties: | |
other_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that isn't represented by the previous fields (between 0 and 100). | |
consumer_to_consumer_volume_percentage: | |
type: integer | |
description: Merchant's percentage of volume that is consumer to consumer (between 0 and 100). | |
business_to_consumer_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to consumer (between 0 and 100). | |
business_to_business_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to business (between 0 and 100). | |
person_to_person_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's person to person (between 0 and 100). | |
entity: | |
type: object | |
description: The underwriting details required to verify `Identities`. | |
properties: | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed (max 19 characters). | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
required: | |
- city | |
- country | |
- region | |
- line1 | |
- postal_code | |
nullable: true | |
properties: | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter Country code (e.g. USA). | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
business_name: | |
type: string | |
description: 'The merchant''s legal business name (max 120 characters).<ul><li>If **INDIVIDUAL_SOLE_PROPRIETORSHIP**, pass the owner''s legal first name, last name and middle initial.</li><li>Special characters (e.g., <code>.</code><code>,</code><code>_</code><code>-</code><code>?</code><code>+</code><code>*</code> or <code>/</code>.) are not allowed.</li></ul>' | |
nullable: true | |
business_phone: | |
type: string | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
business_tax_id: | |
type: string | |
description: 'Nine digit Tax Identification Number (TIN), Employer Identification Number (EIN). If the `business_type` is **INDIVIDUAL\_SOLE\_PROPRIETORSHIP** and they do not have an EIN, use the sole proprietor''s Social Security Number (SSN).' | |
business_type: | |
type: string | |
description: The business entity type of the Merchant. | |
enum: | |
- INDIVIDUAL_SOLE_PROPRIETORSHIP | |
- CORPORATION | |
- LIMITED_LIABILITY_COMPANY | |
- PARTNERSHIP | |
- ASSOCIATION_ESTATE_TRUST | |
- TAX_EXEMPT_ORGANIZATION | |
- INTERNATIONAL_ORGANIZATION | |
- GOVERNMENT_AGENCY | |
default_statement_descriptor: | |
type: string | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
dob: | |
type: object | |
description: The control owner's date of birth. | |
required: | |
- day | |
- month | |
- year | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
year: | |
type: integer | |
description: Year of birth (4-digit). Year must be greater than 1900 | |
doing_business_as: | |
type: string | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
email: | |
type: string | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
first_name: | |
type: string | |
description: The legal first name of the merchant's control owner (max 20 characters). | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
required: | |
- day | |
- month | |
- year | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
description: The legal last name of the control owner (max 20 characters). | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
ach_max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single ACH transaction (max 12 characters). | |
mcc: | |
type: string | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
ownership_type: | |
type: string | |
description: |- | |
Avalible values include: <ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company.<li><strong>PRIVATE</strong> for privately-held businesses. | |
For `business_type` of **GOVERNMENT_AGENCY** and **TAX_EXEMPT_ORGANIZATION** the `ownership_type` should be set to **PUBLIC**. | |
For `business_type` **INDIVIDUAL_SOLE_PROPRIETORSHIP**, the `ownership_type` should be set to **PRIVATE**. | |
enum: | |
- PUBLIC | |
- PRIVATE | |
nullable: true | |
personal_address: | |
type: object | |
description: The billing address of the Principal Owner. This field is used for identity verification purposes. | |
required: | |
- city | |
- country | |
- line1 | |
- postal_code | |
- region | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
country: | |
type: string | |
description: 3-Letter country code (e.g. USA). | |
line1: | |
type: string | |
description: First line of the address (max 35 characters). | |
line2: | |
type: string | |
description: Second line of the address (max 35 characters). | |
postal_code: | |
type: string | |
description: Zip or Postal code (max 7 characters). | |
region: | |
type: string | |
description: 2-letter State code. | |
phone: | |
type: string | |
description: The principal control owner's phone number (max 10 characters). | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
tax_id: | |
type: string | |
description: 'Pass one of the following values (nine digits):<ul><li>Social Security Number (SSN)<li>Tax Identification Number (TIN)<li>Individual Taxpayer Identification Number (ITIN)</ul>' | |
title: | |
type: string | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
url: | |
type: string | |
description: The URL of the merchant's public website. | |
required: | |
- annual_card_volume | |
- business_address | |
- business_name | |
- business_phone | |
- business_tax_id | |
- business_type | |
- default_statement_descriptor | |
- dob | |
- doing_business_as | |
- first_name | |
- has_accepted_credit_cards_previously | |
- incorporation_date | |
- last_name | |
- max_transaction_amount | |
- ach_max_transaction_amount | |
- mcc | |
- ownership_type | |
- personal_address | |
- phone | |
- principal_percentage_ownership | |
- tax_id | |
- title | |
- url | |
tags: | |
$ref: '#/components/schemas/Tags' | |
- title: Identity - Buyer | |
properties: | |
entity: | |
type: object | |
description: The underwriting details required to verify `Identities`. | |
properties: | |
email: | |
type: string | |
description: The email address of the buyer where they can be reached (max 100 characters). | |
first_name: | |
type: string | |
description: The legal first name of the buyer (max 20 characters). | |
last_name: | |
type: string | |
description: The legal last name of the buyer (max 20 characters). | |
personal_address: | |
type: object | |
description: The billing address of the buyer. This field is used for identity verification purposes. | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
country: | |
type: string | |
description: 3-Letter country code (e.g. USA). | |
line1: | |
type: string | |
description: First line of the address (max 35 characters). | |
line2: | |
type: string | |
description: Second line of the address (max 35 characters). | |
postal_code: | |
type: string | |
description: Zip or Postal code (max 7 characters). | |
region: | |
type: string | |
description: 2-letter State code. | |
phone: | |
type: string | |
description: Phone number where the buyer can be reached. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: object | |
UpdateIdentityRequest: | |
anyOf: | |
- title: Update Identity - Merchant | |
properties: | |
additional_underwriting_data: | |
type: object | |
description: Additional underwriting data that's required to verify the `Identity` of merchants. | |
properties: | |
annual_ach_volume: | |
type: integer | |
description: The approximate annual ACH sales expected to be processed (in cents) by this merchant (max 10 characters). | |
average_ach_transfer_amount: | |
type: integer | |
description: The approximate average ACH sale amount (in cents) for this merchant. | |
average_card_transfer_amount: | |
type: integer | |
description: The average credit card sale amount (in cents) for this merchant. | |
business_description: | |
type: string | |
minLength: 1 | |
description: Description of this merchant's business (max 200 characters). | |
credit_check_allowed: | |
type: boolean | |
description: Sets if this merchant has consented and accepted to a credit check. | |
credit_check_ip_address: | |
type: string | |
minLength: 1 | |
description: 'The IP address of the merchant when they consented to a credit check (e.g., 42.1.1.113 ).' | |
credit_check_timestamp: | |
type: string | |
minLength: 1 | |
description: 'A timestamp of when this merchant consented to a credit check (e.g., 2021-04-28T16:42:55Z).' | |
credit_check_user_agent: | |
type: string | |
minLength: 1 | |
description: 'The details of the browser that was used when this merchant consented to a credit check (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
card_volume_distribution: | |
type: object | |
description: The distribution of the merchant's credit card volume The sum of `card_volume_distribution` must be 100. | |
properties: | |
card_present_percentage: | |
type: integer | |
description: The percentage of the merchant's business that's card present (between 0 and 100). | |
ecommerce_percentage: | |
type: integer | |
description: The percentage of the merchant's business that's e-commerce (between 0 and 100). | |
mail_order_telephone_order_percentage: | |
type: integer | |
description: The percentage of the merchant's business that's mail or telephone order (between 0 and 100). | |
merchant_agreement_accepted: | |
type: boolean | |
description: Sets whether this merchant has accepted the terms and conditions of the merchant agreement. | |
merchant_agreement_ip_address: | |
type: string | |
minLength: 1 | |
description: 'IP address of the merchant when this merchant accepted the merchant agreement (e.g., 42.1.1.113).' | |
merchant_agreement_timestamp: | |
type: string | |
minLength: 1 | |
description: 'Timestamp of when the merchant accepted Finix''s Terms of Service (e.g., 2021-04-28T16:42:55Z).' | |
merchant_agreement_user_agent: | |
type: string | |
minLength: 1 | |
description: 'The details of the browser that was used when this merchant accepted Finix''s Terms of Service (e.g., Mozilla 5.0 (Macintosh; Intel Mac OS X 10 _14_6)).' | |
refund_policy: | |
type: string | |
minLength: 1 | |
description: Include the value that best applies to the merchant's refund policy. | |
enum: | |
- NO_REFUNDS | |
- MERCHANDISE_EXCHANGE_ONLY | |
- WITHIN_30_DAYS OTHER | |
volume_distribution_by_business_type: | |
type: object | |
description: Merchant's distribution of credit card volume by business type. Sum of `volume_distribution_by_business_type` must be 100. | |
properties: | |
other_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that isn't represented by the previous fields (between 0 and 100). | |
consumer_to_consumer_volume_percentage: | |
type: integer | |
description: Merchant's percentage of volume that is consumer to consumer (between 0 and 100). | |
business_to_consumer_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to consumer (between 0 and 100). | |
business_to_business_volume_percentage: | |
type: integer | |
description: The percentage of the merchant's volume that's business to business (between 0 and 100). | |
person_to_person_volume_percentage: | |
type: integer | |
description: The percentage the merchant's volume that's person to person (between 0 and 100). | |
entity: | |
type: object | |
description: Underwriting data that's required to verify the `Identity`. | |
properties: | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed (max 19 characters). | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
minLength: 1 | |
country: | |
type: string | |
minLength: 1 | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
business_tax_id: | |
type: string | |
minLength: 1 | |
description: 'Nine digit Tax Identification Number (TIN), Employer Identification Number (EIN). If the `business_type` is **INDIVIDUAL\_SOLE\_PROPRIETORSHIP** and they do not have an EIN, use the sole proprietor''s Social Security Number (SSN).' | |
business_type: | |
type: string | |
minLength: 1 | |
description: Include the value that best applies to the merchant. | |
enum: | |
- INDIVIDUAL_SOLE_PROPRIETORSHIP | |
- CORPORATION | |
- LIMITED_LIABILITY_COMPANY | |
- PARTNERSHIP | |
- ASSOCIATION_ESTATE_TRUST | |
- TAX_EXEMPT_ORGANIZATION | |
- INTERNATIONAL_ORGANIZATION | |
- GOVERNMENT_AGENCY | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
dob: | |
type: object | |
description: | | |
The principal control owner's date of birth. | |
properties: | |
day: | |
type: integer | |
description: Day of birth (between 1 and 31). | |
month: | |
type: integer | |
description: Month of birth (between 1 and 12). | |
year: | |
type: integer | |
description: Year of birth (4-digits). | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner (max 100 characters). | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the control owner (max 20 characters). | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The `Identity` owner's legal last name. | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
ownership_type: | |
type: string | |
minLength: 1 | |
description: |- | |
Values can be either: | |
<ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company. | |
<li><strong>PRIVATE</strong> for privately-held businesses. | |
nullable: true | |
personal_address: | |
type: object | |
description: The home address of the principal control owner. This field is used for identity verification purposes. | |
properties: | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
tax_id: | |
type: string | |
minLength: 1 | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the `Identity` owner's public website. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
- title: Update Identity - Buyer | |
properties: | |
entity: | |
type: object | |
description: Identifying information about the buyer. | |
properties: | |
email: | |
type: string | |
description: The email address of the buyer (max 100 characters). | |
first_name: | |
type: string | |
description: The legal first name of the buyer (max 20 characters). | |
last_name: | |
type: string | |
description: The legal last name of the buyer (max 20 characters). | |
personal_address: | |
type: object | |
description: The billing address of the buyer. This field is used for identity verification purposes. | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
country: | |
type: string | |
description: 3-Letter country code (e.g. USA). | |
line1: | |
type: string | |
description: First line of the address (max 35 characters). | |
line2: | |
type: string | |
description: Second line of the address (max 35 characters). | |
postal_code: | |
type: string | |
description: Zip or Postal code (max 7 characters). | |
phone: | |
type: string | |
description: Phone number where the buyer can be reached. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: object | |
CreateAssociatedIdentityRequest: | |
x-examples: {} | |
type: object | |
properties: | |
entity: | |
type: object | |
description: Underwriting data that's required to verify the `Identity`. | |
properties: | |
annual_card_volume: | |
type: integer | |
description: The annual credit card sales (in cents) expected to be processed (max 19 characters). | |
business_address: | |
type: object | |
description: The primary address for the legal entity. | |
nullable: true | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
minLength: 1 | |
country: | |
type: string | |
minLength: 1 | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter state code. | |
business_name: | |
type: string | |
minLength: 1 | |
description: 'Abbreviated names of the business. If there are no abbreviated name, leave this field blank.' | |
nullable: true | |
business_phone: | |
type: string | |
minLength: 1 | |
description: Customer service phone number where the merchant can be reached (max 10 characters). | |
business_tax_id: | |
type: string | |
minLength: 1 | |
description: 'Nine digit Tax Identification Number (TIN), Employer Identification Number (EIN). If the `business_type` is **INDIVIDUAL\_SOLE\_PROPRIETORSHIP** and they do not have an EIN, use the sole proprietor''s Social Security Number (SSN).' | |
business_type: | |
type: string | |
minLength: 1 | |
description: Include the value that best applies to the merchant. | |
enum: | |
- INDIVIDUAL_SOLE_PROPRIETORSHIP | |
- CORPORATION | |
- LIMITED_LIABILITY_COMPANY | |
- PARTNERSHIP | |
- ASSOCIATION_ESTATE_TRUST | |
- TAX_EXEMPT_ORGANIZATION | |
- INTERNATIONAL_ORGANIZATION | |
- GOVERNMENT_AGENCY | |
default_statement_descriptor: | |
type: string | |
minLength: 1 | |
description: The description of the merchant that appears on the buyer's bank or card statement. | |
dob: | |
type: object | |
description: | | |
The control owner's date of birth. | |
properties: | |
day: | |
type: integer | |
month: | |
type: integer | |
year: | |
type: integer | |
doing_business_as: | |
type: string | |
minLength: 1 | |
description: 'Alternate names of the business. If there are no other names, pass the same value used for `business_name` (max 60 characters).' | |
email: | |
type: string | |
minLength: 1 | |
description: The email address of the principal control owner where they can be reached (max 100 characters). | |
first_name: | |
type: string | |
minLength: 1 | |
description: The legal first name of the control owner (max 20 characters). | |
has_accepted_credit_cards_previously: | |
type: boolean | |
description: Defaults to **false** if not passed. | |
incorporation_date: | |
type: object | |
description: The date the company was founded and registered. | |
nullable: true | |
properties: | |
day: | |
type: integer | |
description: Day business was incorporated (between 1 and 31). | |
month: | |
type: integer | |
description: Month business was incorporated (between 1 and 12). | |
year: | |
type: integer | |
description: Year business was incorporated (4-digit). | |
last_name: | |
type: string | |
minLength: 1 | |
description: The `Identity` owner's legal last name. | |
max_transaction_amount: | |
type: integer | |
description: The maximum amount (in cents) that can be charged for a single transaction (max 12 characters). | |
mcc: | |
type: string | |
minLength: 1 | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
ownership_type: | |
type: string | |
minLength: 1 | |
nullable: true | |
description: |- | |
Values can be either: | |
<ul><li><strong>PUBLIC</strong> to indicate a publicly-traded company. | |
<li><strong>PRIVATE</strong> for privately-held businesses. | |
personal_address: | |
type: object | |
description: The home address of the principal control owner. This field is used for identity verification purposes. | |
properties: | |
city: | |
type: string | |
minLength: 1 | |
description: City (max 20 characters). | |
country: | |
type: string | |
minLength: 1 | |
description: 3-Letter country code (e.g. USA). | |
line1: | |
type: string | |
minLength: 1 | |
description: First line of the address (max 35 characters). | |
line2: | |
type: string | |
minLength: 1 | |
description: Second line of the address (max 35 characters). | |
postal_code: | |
type: string | |
minLength: 1 | |
description: Zip or Postal code (max 7 characters). | |
region: | |
type: string | |
minLength: 1 | |
description: 2-letter State code. | |
phone: | |
type: string | |
minLength: 1 | |
description: The principal control owner's phone number (max 10 characters). | |
principal_percentage_ownership: | |
type: integer | |
description: Percentage of the company owned by the principal control owner (min 0; max 100). | |
tax_id: | |
type: string | |
minLength: 1 | |
description: Details if the `tax_id` was provided. | |
title: | |
type: string | |
minLength: 1 | |
description: 'The corporate title of the control owner (e.g. Chief Executive Officer, CFO, etc. Max 60 characters).' | |
url: | |
type: string | |
minLength: 1 | |
description: The URL of the `Identity` owner's public website. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
Merchant: | |
type: object | |
x-examples: | |
example-1: | |
id: MUucec6fHeaWo3VHYoSkUySM | |
application: APgPDQrLD52TYvqazjHJJchM | |
identity: IDpYDM7J9n57q849o9E9yNrG | |
verification: VIdikDHXv7x8nWyJg8JZemGx | |
merchant_profile: MPzW2oRPtkLxK3fymcMACFi | |
processor: DUMMY_V1 | |
processing_enabled: true | |
settlement_enabled: true | |
gross_settlement_enabled: false | |
creating_transfer_from_report_enabled: true | |
card_expiration_date_required: true | |
card_cvv_required: false | |
tags: | |
key_2: value_2 | |
mcc: '4900' | |
mid: FNX7CwmebftudY7i5mA4qF6XT | |
merchant_name: Petes Coffee | |
settlement_funding_identifier: UNSET | |
ready_to_settle_upon: RECONCILIATION | |
fee_ready_to_settle_upon: RECONCILIATION | |
level_two_level_three_data_enabled: false | |
created_at: '2022-01-27T07:36:58.19Z' | |
updated_at: '2022-01-27T07:36:58.46Z' | |
onboarding_state: APPROVED | |
processor_details: | |
mid: FNX7CwmebftudY7i5mA4qF6XT | |
api_key: secretValue | |
_links: | |
self: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUucec6fHeaWo3VHYoSkUySM' | |
identity: | |
href: 'https://finix.sandbox-payments-api.com/identities/IDpYDM7J9n57q849o9E9yNrG' | |
verifications: | |
href: 'https://finix.sandbox-payments-api.com/merchants/MUucec6fHeaWo3VHYoSkUySM/verifications' | |
merchant_profile: | |
href: 'https://finix.sandbox-payments-api.com/merchant_profiles/MPzW2oRPtkLxK3fymcMACFi' | |
application: | |
href: 'https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM' | |
verification: | |
href: 'https://finix.sandbox-payments-api.com/verifications/VIdikDHXv7x8nWyJg8JZemGx' | |
title: Merchant | |
properties: | |
id: | |
type: string | |
description: The ID of the `Merchant` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: ID of the `Application` the `Merchant` was created under. | |
card_cvv_required: | |
type: boolean | |
description: Set to **true** to require the card's CVV code. | |
card_expiration_date_required: | |
type: boolean | |
description: Set to **true** to require the card's expiration date. | |
creating_transfer_from_report_enabled: | |
type: boolean | |
description: Set to **true** to automatically create `Transfers` once settlement reports get generated. | |
convenience_charges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable the `Merchant` to accept convenience fees and/or service fees. | |
fee_ready_to_settle_upon: | |
type: string | |
description: Details how the `Merchant` settles fees. | |
gateway: | |
type: string | |
description: Name of the gateway that routes the `Merchant's` transactions to the processor. | |
enum: | |
- TRIPOS_MOBILE_V1 | |
- TRIPOS_CLOUD_V1 | |
- DATACAP_V1 | |
nullable: true | |
gross_settlement_enabled: | |
type: boolean | |
description: Set to **true** to enable gross settlements. | |
identity: | |
type: string | |
description: The ID of the `Identity` resource associated with the `Merchant`. | |
level_two_level_three_data_enabled: | |
type: boolean | |
description: Set to **true** to enable the `Merchant` for Level 2 and Level 3 processing. Default value is **false**. | |
mcc: | |
type: string | |
description: 'The Merchant Category Code ([MCC](http://www.dm.usda.gov/procurement/card/card\_x/mcc.pdf)) that this merchant will be classified under. For a list of approved MCCs, see [Approved Merchant Category Codes.](/guides/business/security-and-compliance/approved-merchants/)' | |
nullable: true | |
merchant_name: | |
type: string | |
description: The legal name saved in the `Merchant` resource. | |
merchant_profile: | |
type: string | |
description: Details if a merchant's info was submitted to third-party processors for provisioning. | |
mid: | |
type: string | |
description: MID of the `Merchant`. | |
nullable: true | |
onboarding_state: | |
type: string | |
enum: | |
- PROVISIONING | |
- APPROVED | |
- REJECTED | |
description: Details the state of the `Merchant's` onboarding. | |
processor: | |
type: string | |
description: Name of the transaction processor. | |
processor_details: | |
type: object | |
description: Additional details specific to the processor. | |
properties: | |
api_key: | |
type: string | |
mid: | |
type: string | |
processing_enabled: | |
type: boolean | |
description: Details if transaction processing is enabled for the `Merchant`. | |
ready_to_settle_upon: | |
type: string | |
description: Details how transactions captured by the `Merchant` are settled. | |
enum: | |
- RECONCILIATION | |
- SUCCESSFUL_CAPTURE | |
- PROCESSOR_WINDOW | |
rent_surcharges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable a `Merchant` to accept rent charges. | |
settlement_enabled: | |
type: boolean | |
description: Details if settlement processing is enabled for the `Merchant`. | |
settlement_funding_identifier: | |
type: string | |
description: |- | |
Includes additional information (like the MID or `Merchant` name) when submitting funding `Transfers` to processors. | |
- **UNSET**: No additional details get provided to the processor. | |
- **MID_AND_DATE**: The `MID` of the `Merchant` and the date the funding `Transfer` was submitted (Date is in UTC). e.g **MID:12345678-20220225** | |
- **MID_AND_MERCHANT_NAME**: The `MID` of the `Merchant` and the `Merchant#name` (white spaces will be removed). e.g. **MID:12345678-NameOfMerchant** | |
These details appear alongside the seller's payout in their bank account as a description of the deposit. | |
enum: | |
- UNSET | |
- MID_AND_DATE | |
- MID_AND_MERCHANT_NAME | |
default: UNSET | |
surcharges_enabled: | |
type: boolean | |
default: false | |
description: 'Set to **true** if you want to enable a `Merchant` to accept surcharge fees. For more details, see [Buyer Charges](/guides/payments/modify/buyer-charges/).' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
verification: | |
type: string | |
description: ID of the `Verification` that was submitted to verify the `Merchant`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
merchant_profile: | |
type: object | |
description: Link to the `merchant_profile` the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
verification: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Identity` that the request was made under. | |
properties: | |
href: | |
type: string | |
MerchantProfile: | |
type: object | |
description: '' | |
properties: | |
id: | |
type: string | |
description: The ID of the `Merchant Profile` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` associated with the `Merchant Profile`. | |
fee_profile: | |
type: string | |
description: The ID of the `Fee Profile` associated with the `Merchant Profile` resource. | |
nullable: true | |
payout_profile: | |
type: string | |
description: The ID of the `Payout Profile` associated with the `Merchant Profile` resource. | |
nullable: true | |
risk_profile: | |
type: string | |
description: The ID of the `Risk Profile` associated with the `Merchant Profile` resource. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
fee_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
owner_identity: | |
type: object | |
properties: | |
href: | |
type: string | |
processors: | |
type: object | |
properties: | |
href: | |
type: string | |
reserve_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
risk_profile: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
users: | |
type: object | |
properties: | |
href: | |
type: string | |
MerchantProfilesList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `merchant_profile` objects. | |
properties: | |
merchant_profiles: | |
type: array | |
description: '`merchant_profile` objects.' | |
items: | |
$ref: '#/components/schemas/MerchantProfile' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
CreateMerchantUnderwritingRequest: | |
type: object | |
title: MerchantUnderwritingCreate | |
properties: | |
gateway: | |
type: string | |
enum: | |
- TRIPOS_CLOUD_V1 | |
- TRIPOS_MOBILE_V1 | |
- DATACAP_V1 | |
description: Name of the gateway that processes the `Merchant's` card present transactions. Use `gateway` only to enable a merchant to accept card present transactions. | |
default_partial_authorization_enabled: | |
type: boolean | |
default: false | |
description: |- | |
- Set to **true** if you want to enable partial authorizations for a specific `Merchant`. | |
- Partial authorizations enables the `Merchant` to collect a portion of the amount if the cardholder doesn't have the funds to cover the entire amount on their card. | |
processor: | |
$ref: '#/components/schemas/ProcessorRequest' | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- processor | |
UpdateMerchantRequest: | |
anyOf: | |
- title: Merchant | |
properties: | |
card_cvv_required: | |
type: boolean | |
description: Set to **true** to require the card's CVV code. | |
card_expiration_date_required: | |
type: boolean | |
description: Set to **true** to require the card's expiration date. | |
convenience_charges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable the `Merchant` to accept convenience fees and/or service fees. | |
creating_transfer_from_report_enabled: | |
type: boolean | |
description: Set to **true** to automatically create `Transfers` once settlement reports get generated. | |
fee_ready_to_settle_upon: | |
type: string | |
description: Details how the `Merchant` settles fees. | |
gross_settlement_enabled: | |
type: boolean | |
description: Set to **true** to enable gross settlements. | |
level_two_level_three_data_enabled: | |
type: boolean | |
description: Set to **true** to enable the `Merchant` for Level 2 and Level 3 processing. Default value is **false**. | |
merchant_name: | |
type: string | |
description: The legal name saved in the `Merchant` resource. | |
processing_enabled: | |
type: boolean | |
description: Details if transaction processing is enabled for the `Merchant`. | |
ready_to_settle_upon: | |
type: string | |
description: Details how transactions captured by the `Merchant` are settled. | |
rent_surcharges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable a `Merchant` to accept rent charges. | |
settlement_enabled: | |
type: boolean | |
description: Details if settlement processing is enabled for the `Merchant`. | |
settlement_funding_identifier: | |
type: string | |
enum: | |
- UNSET | |
- MID_AND_DATE | |
- MID_AND_MERCHANT_NAME | |
default: UNSET | |
description: |- | |
Includes additional information (like the MID or `Merchant` name) when submitting funding `Transfers` to processors. | |
- **UNSET**: No additional details get provided to the processor. | |
- **MID_AND_DATE**: The `MID` of the `Merchant` and the date the funding `Transfer` was submitted (Date is in UTC). e.g **MID:12345678-20220225** | |
- **MID_AND_MERCHANT_NAME**: The `MID` of the `Merchant` and the `Merchant#name` (white spaces will be removed). e.g. **MID:12345678-NameOfMerchant** | |
These details appear alongside the seller's payout in their bank account as a description of the deposit. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
- title: Merchant - Disable a Merchant | |
properties: | |
processing_enabled: | |
type: boolean | |
description: Details if transaction processing is enabled for the `Merchant`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- processing_enabled | |
- title: Merchant - Enable Buyer Charges | |
properties: | |
convenience_charges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable the `Merchant` to accept convenience fees and/or service fees. | |
rent_surcharges_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable a `Merchant` to accept rent charges. | |
surcharge_fees_enabled: | |
type: boolean | |
description: Set to **true** if you want to enable a `Merchant` to accept surcharge fees. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- convenience_charges_enabled | |
- rent_surcharges_enabled | |
- surcharge_fees_enabled | |
- title: Merchant - Enable Level 2/3 Processing | |
properties: | |
level_two_level_three_data_enabled: | |
type: boolean | |
description: Set to **true** to enable the `Merchant` for Level 2 and Level 3 processing. Default value is **false**. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- level_two_level_three_data_enabled | |
- title: Merchant - Enable Partial Authorizations | |
properties: | |
default_partial_authorization_enabled: | |
type: boolean | |
description: |- | |
- Set to **true** if you want to enable partial authorizations for a specific `Merchant`. | |
- Partial authorizations enables the `Merchant` to collect a portion of the amount if the cardholder doesn't have the funds to cover the entire amount on their card. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: object | |
MerchantsList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `Merchant` objects. | |
properties: | |
merchants: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Merchant` objects.' | |
items: | |
$ref: '#/components/schemas/Merchant' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
PaymentInstrument: | |
anyOf: | |
- title: Payment Instrument - Card | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
address: | |
$ref: '#/components/schemas/Address' | |
address_verification: | |
type: string | |
enum: | |
- POSTAL_CODE_AND_STREET_MATCH | |
- STREET_MATCH | |
- POSTAL_CODE_MATCH | |
- NO_ADDRESS | |
- NO_MATCH | |
- NOT_SUPPORTED | |
- UNKNOWN | |
description: |- | |
- Details the results of verifying `address` with the issuing bank. | |
- Set to **UNKNOWN** when `address` gets updated. | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
bin: | |
type: string | |
description: Bank Identification number for the `Payment Instrument`. | |
brand: | |
type: string | |
enum: | |
- UNKNOWN | |
- DINERS_CLUB_INTERNATIONAL | |
- DANKORT | |
- MIR | |
- TROY | |
- UATP | |
- CHINA_T_UNION | |
- CHINA_UNION_PAY | |
- AMERICAN_EXPRESS | |
- VERVE | |
- RUPAY | |
- DISCOVER | |
- JCB | |
- MASTERCARD | |
- INTERPAYMENT | |
- INSTAPAYMENT | |
- MAESTRO | |
- VISA | |
- LANKAPAY | |
- DINERS_CLUB | |
description: The `brand` of the card saved in the `Payment Instrument`. | |
card_name: | |
type: string | |
description: A custom name you can include to identify the card being used (e.g. **Business Card**). | |
nullable: true | |
card_type: | |
type: string | |
enum: | |
- CREDIT | |
- DEBIT | |
- HSA_FSA | |
- NON_RELOADABLE_PREPAID | |
- RELOADABLE_PREPAID | |
- UNKNOWN | |
description: The type of payment card saved in the `Payment Instrument`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
expiration_month: | |
type: integer | |
maximum: 12 | |
minimum: 1 | |
description: Expiration month (e.g. 12 for December). | |
expiration_year: | |
type: integer | |
minimum: 1 | |
description: 4-digit expiration year. | |
fast_funds_indicator: | |
type: string | |
description: Details if Fast Funds is enabled for the card. | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- PAYMENT_CARD | |
description: The type of `Payment Instrument`. | |
issuer_country: | |
type: string | |
enum: | |
- USA | |
- NON_USA | |
- UNKNOWN | |
description: 'Details what country the card was issued in:<li><strong>USA</strong>: The card was issued inside the United States.<li><strong>NON_USA</strong>: The card was issued outside of the United States.<li><strong>UNKNOWN</strong>: Processor did not return an issuer country for this particular BIN.' | |
last_four: | |
type: string | |
description: Last four digits of the card or bank account number. | |
name: | |
type: string | |
description: The name of the bank account or card owner. | |
nullable: true | |
online_gambing_block_indicator: | |
type: string | |
description: Detailes if the card is enabled to receive push-payments for online gambling payouts. | |
payload_type: | |
type: string | |
enum: | |
- SOURCE | |
- DESTINATION | |
push_funds_block_indicator: | |
type: string | |
description: Details if the card is enabled to receive push-to-card disbursements. | |
security_code_verification: | |
type: string | |
enum: | |
- MATCHED | |
- UNKNOWN | |
- UNMATCHED | |
description: Details the results of the Card Verification Code check. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- PAYMENT_CARD | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
updates: | |
type: object | |
description: Link to the `Updates` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Bank Account | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
account_type: | |
type: string | |
enum: | |
- CHECKING | |
- SAVINGS | |
description: Details what kind of **BANK_ACCOUNT** is being used. | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
bank_account_validation_check: | |
type: string | |
enum: | |
- INCONCLUSIVE | |
- INVALID | |
- NOT_ATTEMPTED | |
- VALID | |
default: NOT_ATTEMPTED | |
description: |- | |
Details the results of the bank account validation check if `attempt_bank_account_validation_check` is set to **true** or the `Payment Instrument` gets used to create a `Transfer`. | |
- **INCONCLUSIVE**: A verification check was performed, but the bank account couldn't be found or verified with the issuing bank. Reach out to the buyer to verify the details collected or request another method of payment, | |
- **INVALID**: The `Payment Instrument` was used in transactions that returned one of the following ACH errors: <ul><li>**Account Does Not Allow ACH Transactions**</li><li>**Account is Closed**</li><li>**Account Funds are Frozen**</li><li>**Deceased Account Holder**</li><li>**Invalid Account Number**</li><li>**Invalid Routing Number**</li><li>**No Account on File**</li></ul>. For more details on the different ACH failure codes, see [ACH Direct Debit.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/#failed-ach-direct-debits) | |
- **NOT_ATTEMPTED**: A verification check wasn't performed and the `Payment Instrument` hasn't been used to create a `Transfer` or `Authorization`. | |
- **VALID**: The bank account was verified. The `Payment Instrument` can be used to create [ACH Direct Debits.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/#failed-ach-direct-debits) | |
bank_code: | |
type: string | |
description: The routing number of the bank account. | |
country: | |
$ref: '#/components/schemas/Country' | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- BANK_ACCOUNT | |
description: The type of `Payment Instrument`. | |
masked_account_number: | |
type: string | |
description: The last 4 digits of the account number used to create the `Payment Instrument`. | |
nullable: true | |
name: | |
type: string | |
description: The name of the bank account or card owner. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- BANK_ACCOUNT | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Token | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
address: | |
$ref: '#/components/schemas/Address' | |
address_verification: | |
type: string | |
description: Additional address information that’s required to verify the identity of the merchant. | |
enum: | |
- POSTAL_CODE_AND_STREET_MATCH | |
- STREET_MATCH | |
- POSTAL_CODE_MATCH | |
- NO_ADDRESS | |
- NO_MATCH | |
- NOT_SUPPORTED | |
- UNKNOWN | |
application: | |
type: string | |
description: The ID of the `Application` resource. | |
bin: | |
type: string | |
description: Bank Identification number for the `Payment Instrument`. | |
brand: | |
type: string | |
description: The `brand` of the card saved in the `Payment Instrument`. | |
card_type: | |
type: string | |
description: The type of payment card saved in the `Payment Instrument`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
expiration_month: | |
type: integer | |
description: Expiration month (e.g. 12 for December). | |
minimum: 1 | |
maximum: 12 | |
expiration_year: | |
type: integer | |
description: 4-digit expiration year. | |
minimum: 1 | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- TOKEN | |
description: The type of `Payment Instrument`. | |
last_four: | |
type: string | |
description: Last four digits of the card or bank account number. | |
name: | |
type: string | |
description: The name of the bank account or card owner. | |
nullable: true | |
security_code_verification: | |
type: string | |
description: Details the results of the Card Verification Code check. | |
enum: | |
- MATCHED | |
- UNKNOWN | |
- UNMATCHED | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- TOKEN | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Apple Pay | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
bin: | |
type: string | |
description: Bank Identification number for the `Payment Instrument`. | |
brand: | |
type: string | |
description: The `brand` of the card saved in the `Payment Instrument`. | |
card_type: | |
type: string | |
description: The type of payment card saved in the `Payment Instrument`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
expiration_month: | |
type: integer | |
description: Expiration month (e.g. 12 for December). | |
minimum: 1 | |
maximum: 12 | |
expiration_year: | |
type: integer | |
description: 4-digit expiration year. | |
minimum: 1 | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- APPLE_PAY | |
description: The type of `Payment Instrument`. | |
payload_type: | |
type: string | |
enum: | |
- SOURCE | |
- DESTINATION | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- APPLE_PAY | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Google Pay | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
bin: | |
type: string | |
description: Bank Identification number for the `Payment Instrument`. | |
brand: | |
type: string | |
description: The `brand` of the card saved in the `Payment Instrument`. | |
card_type: | |
type: string | |
description: The type of payment card saved in the `Payment Instrument`. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
expiration_month: | |
type: integer | |
description: Expiration month (e.g. 12 for December). | |
minimum: 1 | |
maximum: 12 | |
expiration_year: | |
type: integer | |
description: 4-digit expiration year. | |
minimum: 1 | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- GOOGLE_PAY | |
description: The type of `Payment Instrument`. | |
payload_type: | |
type: string | |
enum: | |
- SOURCE | |
- DESTINATION | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- GOOGLE_PAY | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Other | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- VIRTUAL | |
- SWIPED_PAYMENT_CARD | |
- PAYMENT_CARD_PRESENT | |
- VANTIV_OMNI_TOKEN | |
description: The type of `Payment Instrument`. | |
payload_type: | |
type: string | |
enum: | |
- SOURCE | |
- DESTINATION | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- VIRTUAL | |
- SWIPED_PAYMENT_CARD | |
- PAYMENT_CARD_PRESENT | |
- VANTIV_OMNI_TOKEN | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
- title: Payment Instrument - Bank Account Validation Check | |
properties: | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
account_type: | |
type: string | |
enum: | |
- CHECKING | |
- SAVINGS | |
description: Details what kind of **BANK_ACCOUNT** is being used. | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
bank_account_validation_check: | |
type: string | |
enum: | |
- INCONCLUSIVE | |
- INVALID | |
- NOT_ATTEMPTED | |
- VALID | |
default: NOT_ATTEMPTED | |
description: |- | |
Details the results of the bank account validation check if `attempt_bank_account_validation_check` is set to **true** or the `Payment Instrument` gets used to create a `Transfer`. | |
- **INCONCLUSIVE**: A verification check was performed, but the bank account couldn't be found or verified with the issuing bank. Reach out to the buyer to verify the details collected or request another method of payment, | |
- **INVALID**: The `Payment Instrument` was used in transactions that returned one of the following ACH errors: <ul><li>**Account Does Not Allow ACH Transactions**</li><li>**Account is Closed**</li><li>**Account Funds are Frozen**</li><li>**Deceased Account Holder**</li><li>**Invalid Account Number**</li><li>**Invalid Routing Number**</li><li>**No Account on File**</li></ul>. For more details on the different ACH failure codes, see [ACH Direct Debit.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/#failed-ach-direct-debits) | |
- **NOT_ATTEMPTED**: A verification check wasn't performed and the `Payment Instrument` hasn't been used to create a `Transfer` or `Authorization`. | |
- **VALID**: The bank account was verified. The `Payment Instrument` can be used to create [ACH Direct Debits.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/#failed-ach-direct-debits) | |
bank_code: | |
type: string | |
description: The routing number of the bank account. | |
country: | |
$ref: '#/components/schemas/Country' | |
currency: | |
$ref: '#/components/schemas/Currency' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
description: Unique ID that represents the tokenized card data. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- BANK_ACCOUNT | |
description: The type of `Payment Instrument`. | |
masked_account_number: | |
type: string | |
description: The last 4 digits of the account number used to create the `Payment Instrument`. | |
nullable: true | |
name: | |
type: string | |
description: The name of the bank account or card owner. | |
nullable: true | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- BANK_ACCOUNT | |
description: Type of `Payment Instrument`. | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
description: Link to the `Authorizations` created under the resource. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
description: Link to the `Transfers` created under the resource. | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` that was used to verify the `Merchant` that the request was made under. | |
properties: | |
href: | |
type: string | |
application: | |
type: object | |
description: Link to the `Application` the request was made under. | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
description: Link to the `Identity` the request was made under. | |
properties: | |
href: | |
type: string | |
type: object | |
CreatePaymentInstrumentRequest: | |
anyOf: | |
- title: Payment Instrument - Card | |
properties: | |
address: | |
type: object | |
description: |- | |
The address of the card owner. | |
**Note**: Including a postal or zip code when creating a `Payment Instrument` can lower the interchange on credit card transactions. | |
properties: | |
city: | |
type: string | |
description: City (max 20 characters). | |
region: | |
type: string | |
description: 2-letter State code. | |
postal_code: | |
type: string | |
description: Zip or Postal code (max 7 characters). | |
line1: | |
type: string | |
description: First line of the address (max 35 characters). | |
country: | |
type: string | |
description: 3 Letter country code (e.g. USA). | |
expiration_month: | |
type: integer | |
description: The expiration month of the card (e.g. 12 for December). | |
expiration_year: | |
type: integer | |
description: The 4-digit expiration year of the card. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
name: | |
type: string | |
description: The name of the bank account or card owner. This value can get truncated to comply with processor requirements. | |
number: | |
type: string | |
description: The card or bank account number (no dashes in between numbers). | |
security_code: | |
type: string | |
description: The 3-4 digit security code of the card (i.e. CVV code). | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
description: Type of `Payment Instrument`. | |
enum: | |
- PAYMENT_CARD | |
third_party_token: | |
type: string | |
description: Stringified token provided by Apple or Google. Required if using Apple or Google Pay. | |
required: | |
- expiration_month | |
- expiration_year | |
- identity | |
- name | |
- number | |
- security_code | |
- type | |
- title: Payment Instrument - Bank Account | |
properties: | |
account_number: | |
type: string | |
description: The bank account number (no dashes in between numbers). | |
minLength: 5 | |
maxLength: 17 | |
account_type: | |
type: string | |
enum: | |
- PERSONAL_CHECKING | |
- PERSONAL_SAVINGS | |
- BUSINESS_CHECKING | |
- BUSINESS_SAVINGS | |
description: 'The type of bank account. Use the following respective enum when creating a `Payment Instrument` for:<ul><li><strong>PERSONAL_CHECKING: </strong>A personal checking account.</li><li><strong>PERSONAL_SAVINGS: </strong>A personal savings account.</li><li><strong>BUSINESS_CHECKING: </strong>A business checking account.</li><li><strong>BUSINESS_SAVINGS: </strong>A business savings account.</li></ul>' | |
attempt_bank_account_validation_check: | |
type: boolean | |
description: |- | |
Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/) | |
- Set to **True** to verify the `Payment Instrument` can be used for ACH payments. | |
default: false | |
bank_code: | |
type: string | |
description: The routing number of the bank account. | |
minLength: 9 | |
maxLength: 9 | |
example: '123456789' | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
name: | |
type: string | |
description: The name of the bank account or card owner. This value can get truncated to comply with processor requirements. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
enum: | |
- BANK_ACCOUNT | |
description: Type of `Payment Instrument`. | |
required: | |
- account_number | |
- account_type | |
- bank_code | |
- identity | |
- type | |
- title: Payment Instrument - Token | |
properties: | |
attempt_bank_account_validation_check: | |
type: boolean | |
description: |- | |
Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/) | |
- Set to **True** to verify the `Payment Instrument` can be used for ACH payments. | |
- Only `Payment Instruments` created from bank accounts can be used for ACH payments. | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
name: | |
type: string | |
description: The name of the bank account or card owner. This value can get truncated to comply with processor requirements. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
token: | |
type: string | |
description: ID of the `Token` that was returned from the tokenization client or hosted fields | |
type: | |
type: string | |
enum: | |
- TOKEN | |
description: Type of `Payment Instrument`. | |
required: | |
- identity | |
- token | |
- type | |
- title: Payment Instrument - Apple Pay | |
properties: | |
identity: | |
type: string | |
description: The `Identity#id` of the buyer and owner of the card. | |
merchant_identity: | |
type: string | |
name: | |
type: string | |
description: The `id` of the `Identity` used when registering the seller with Apple Pay through our registration API. | |
third_party_token: | |
type: string | |
description: Stringified token provided by Apple. Required to process Apple Pay transactions. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
type: | |
type: string | |
description: Type of `Payment Instrument`. | |
enum: | |
- APPLE_PAY | |
required: | |
- identity | |
- merchant_identity | |
- third_party_token | |
- type | |
- title: Payment Instrument - Google Pay | |
properties: | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
merchant_identity: | |
type: string | |
description: The `id` of the identity used when registering the business with Google Pay through our registration API. | |
name: | |
type: string | |
description: The name of the bank account or card owner. This value can get truncated to comply with processor requirements. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
third_party_token: | |
type: string | |
description: Stringified token provided by Google. Required to process Google Pay transactions. | |
type: | |
type: string | |
enum: | |
- GOOGLE_PAY | |
description: Type of `Payment Instrument`. | |
required: | |
- identity | |
- merchant_identity | |
- third_party_token | |
type: object | |
UpdatePaymentInstrumentRequest: | |
anyOf: | |
- title: Payment Instrument - Update a Card's Address | |
properties: | |
address: | |
$ref: '#/components/schemas/Address' | |
merchant: | |
default: false | |
type: string | |
description: The ID of the `Merchant` that the `Payment Instrument` will be created under. | |
verify_payment_card: | |
type: boolean | |
description: |- | |
- Set to **true** to verify card details with the card issuer. | |
- Must be set to **true** to update the CVV or security code of a card. | |
- When set to **true**, `merchant` must also be included with your request. | |
default: false | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- address | |
- merchant | |
- verify_payment_card | |
- title: Payment Instrument - Disable a Payment Instrument | |
properties: | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Default value is **true**; set to **false** to disable the `Payment Instrument`. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- enabled | |
- title: Payment Instrument - Update Name | |
properties: | |
name: | |
type: string | |
default: false | |
description: The name of the bank account or card owner. This value can get truncated to comply with processor requirements. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- name | |
- title: Payment Instrument - Bank Account Validation Check | |
properties: | |
attempt_bank_account_validation_check: | |
type: boolean | |
default: false | |
description: |- | |
Verify and validate the `Payment Instrument` to confirm it can be used for [ACH Direct Debits.](/guides/payments/online-payments/getting-started/finix-api/ach-echeck/) | |
- Set to **True** to verify the `Payment Instrument` can be used for ACH payments. | |
- Only `Payment Instruments` created from bank accounts can be used for ACH payments. | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- attempt_bank_account_validation_check | |
- title: Payment Instrument - Update Payment Instrument Tags | |
properties: | |
tags: | |
$ref: '#/components/schemas/Tags' | |
required: | |
- tags | |
type: object | |
PaymentInstrumentToken: | |
type: object | |
title: Payment instrument | |
properties: | |
tags: | |
$ref: '#/components/schemas/Tags' | |
enabled: | |
type: boolean | |
description: Details if the `Payment Instrument` resource is enabled. Set to `false` to disable the `Payment Instrument`. | |
type: | |
type: string | |
enum: | |
- TOKEN | |
id: | |
type: string | |
description: The ID of the `Payment Instrument`. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource the `Payment Instrument` was created under. | |
currency: | |
$ref: '#/components/schemas/Currency' | |
fingerprint: | |
type: string | |
example: FPRxxxxxxxxxxxxxxxxx | |
identity: | |
type: string | |
description: The ID of the `Identity` used to create the `Payment Instrument` resource. | |
instrument_type: | |
type: string | |
enum: | |
- TOKEN | |
payload_type: | |
type: string | |
enum: | |
- SOURCE | |
- DESTINATION | |
_links: | |
type: object | |
description: 'For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these `_links` to make your follow-up requests and quickly access relevant IDs.' | |
properties: | |
application: | |
type: object | |
description: Link to the `Application` the resource was created under. | |
properties: | |
href: | |
type: string | |
authorizations: | |
type: object | |
properties: | |
href: | |
type: string | |
identity: | |
type: object | |
properties: | |
href: | |
type: string | |
self: | |
type: object | |
description: Link to the resource that was used in the request. | |
properties: | |
href: | |
type: string | |
transfers: | |
type: object | |
properties: | |
href: | |
type: string | |
verifications: | |
type: object | |
description: Link to the `Verification` the request was made under. | |
properties: | |
href: | |
type: string | |
PaymentInstrumentUpdatesList: | |
type: object | |
description: '' | |
properties: | |
page: | |
$ref: '#/components/schemas/PageOffset' | |
_embedded: | |
type: object | |
description: List of `updates` for a `Payment Instrument`. | |
properties: | |
updates: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Update` objects.' | |
items: | |
$ref: '#/components/schemas/InstrumentUpdate' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
PaymentInstrumentsList: | |
type: object | |
properties: | |
page: | |
$ref: '#/components/schemas/PageCursor' | |
_embedded: | |
type: object | |
description: List of `Payment Instrument` objects. | |
properties: | |
payment_instruments: | |
type: array | |
minItems: 0 | |
uniqueItems: true | |
description: '`Payment Instrument` objects.' | |
items: | |
$ref: '#/components/schemas/PaymentInstrument' | |
_links: | |
$ref: '#/components/schemas/ListLinks' | |
Processor: | |
description: '' | |
type: object | |
properties: | |
id: | |
type: string | |
example: PRxxxxxxxxxxxxxxxxxx | |
description: ID of the `Processor` resource. | |
created_at: | |
$ref: '#/components/schemas/CreatedAt' | |
updated_at: | |
$ref: '#/components/schemas/UpdatedAt' | |
application: | |
type: string | |
description: The ID of the `Application` resource. | |
application_config: | |
type: object | |
description: Details that configure how the `Processor` handles transactions. | |
nullable: true | |
properties: | |
ach_settlement_delay_days: | |
type: integer | |
minimum: 0 | |
x-finix-issues: | |
- property2 | |
description: Details how days ACH settlments are delayed by. | |
nullable: true | |
allow_split_payouts: | |
type: boolean | |
description: Details if the `Processor` allows split payouts to `Merchants`. | |
allowed_business_application_ids: | |
type: array | |
description: Identifies the `Processors` business application type for VisaNet transaction processing. | |
items: | |
type: string | |
enum: | |
- AA | |
- BB | |
- BI | |
- CP | |
- FD | |
- FT | |
- GD | |
- GP | |
- LO | |
- CI | |
- CO | |
- MP | |
- MD | |
- OG | |
- PD | |
- PP | |
- TU | |
- WT | |
card_acceptor_id_code: | |
type: string | |
description: 'An ID for the card acceptor (e.g Visa). ' | |
card_acceptor_terminal_id: | |
type: string | |
description: The ID for the terminal at a card acceptor location. | |
configuration_templates: | |
type: object | |
nullable: true | |
properties: | |
country: | |
type: object | |
description: 3-Letter Country code. | |
default_currencies: | |
type: array | |
description: ISO 4217 3 letter currency code. | |
items: | |
$ref: '#/components/schemas/Currency' | |
default_mcc: | |
type: string | |
enum: | |
- '0742' | |
- '0763' | |
- '0780' | |
- '1520' | |
- '1711' | |
- '1731' | |
- '1740' | |
- '1750' | |
- '1761' | |
- '1771' | |
- '1799' | |
- '2741' | |
- '2791' | |
- '2842' | |
- '3000' | |
- '3001' | |
- '3002' | |
- '3003' | |
- '3004' | |
- '3005' | |
- '3006' | |
- '3007' | |
- '3008' | |
- '3009' | |
- '3010' | |
- '3011' | |
- '3012' | |
- '3013' | |
- '3014' | |
- '3015' | |
- '3016' | |
- '3017' | |
- '3018' | |
- '3019' | |
- '3020' | |
- '3021' | |
- '3022' | |
- '3023' | |
- '3024' | |
- '3025' | |
- '3026' | |
- '3027' | |
- '3028' | |
- '3029' | |
- '3030' | |
- '3031' | |
- '3032' | |
- '3033' | |
- '3034' | |
- '3035' | |
- '3036' | |
- '3037' | |
- '3038' | |
- '3039' | |
- '3040' | |
- '3041' | |
- '3042' | |
- '3043' | |
- '3044' | |
- '3045' | |
- '3046' | |
- '3047' | |
- '3048' | |
- '3049' | |
- '3050' | |
- '3051' | |
- '3052' | |
- '3053' | |
- '3054' | |
- '3055' | |
- '3056' | |
- '3057' | |
- '3058' | |
- '3059' | |
- '3060' | |
- '3061' | |
- '3062' | |
- '3063' | |
- '3064' | |
- '3065' | |
- '3066' | |
- '3067' | |
- '3068' | |
- '3069' | |
- '3070' | |
- '3071' | |
- '3072' | |
- '3073' | |
- '3074' | |
- '3075' | |
- '3076' | |
- '3077' | |
- '3078' | |
- '3079' | |
- '3080' | |
- '3081' | |
- '3082' | |
- '3083' | |
- '3084' | |
- '3085' | |
- '3086' | |
- '3087' | |
- '3088' | |
- '3089' | |
- '3090' | |
- '3091' | |
- '3092' | |
- '3093' | |
- '3094' | |
- '3095' | |
- '3096' | |
- '3097' | |
- '3098' | |
- '3099' | |
- '3100' | |
- '3101' | |
- '3102' | |
- '3103' | |
- '3104' | |
- '3105' | |
- '3106' | |
- '3107' | |
- '3108' | |
- '3109' | |
- '3110' | |
- '3111' | |
- '3112' | |
- '3113' | |
- '3114' | |
- '3115' | |
- '3116' | |
- '3117' | |
- '3118' | |
- '3119' | |
- '3120' | |
- '3121' | |
- '3122' | |
- '3123' | |
- '3124' | |
- '3125' | |
- '3126' | |
- '3127' | |
- '3128' | |
- '3129' | |
- '3130' | |
- '3131' | |
- '3132' | |
- '3133' | |
- '3134' | |
- '3135' | |
- '3136' | |
- '3137' | |
- '3138' | |
- '3139' | |
- '3140' | |
- '3141' | |
- '3142' | |
- '3143' | |
- '3144' | |
- '3145' | |
- '3146' | |
- '3147' | |
- '3148' | |
- '3149' | |
- '3150' | |
- '3151' | |
- '3152' | |
- '3153' | |
- '3154' | |
- '3155' | |
- '3156' | |
- '3157' | |
- '3158' | |
- '3159' | |
- '3160' | |
- '3161' | |
- '3162' | |
- '3163' | |
- '3164' | |
- '3165' | |
- '3166' | |
- '3167' | |
- '3168' | |
- '3169' | |
- '3170' | |
- '3171' | |
- '3172' | |
- '3173' | |
- '3174' | |
- '3175' | |
- '3176' | |
- '3177' | |
- '3178' | |
- '3179' | |
- '3180' | |
- '3181' | |
- '3182' | |
- '3183' | |
- '3184' | |
- '3185' | |
- '3186' | |
- '3187' | |
- '3188' | |
- '3189' | |
- '3190' | |
- '3191' | |
- '3192' | |
- '3193' | |
- '3194' | |
- '3195' | |
- '3196' | |
- '3197' | |
- '3198' | |
- '3199' | |
- '3200' | |
- '3201' | |
- '3202' | |
- '3203' | |
- '3204' | |
- '3205' | |
- '3206' | |
- '3207' | |
- '3208' | |
- '3209' | |
- '3210' | |
- '3211' | |
- '3212' | |
- '3213' | |
- '3214' | |
- '3215' | |
- '3216' | |
- '3217' | |
- '3218' | |
- '3219' | |
- '3220' | |
- '3221' | |
- '3222' | |
- '3223' | |
- '3224' | |
- '3225' | |
- '3226' | |
- '3227' | |
- '3228' | |
- '3229' | |
- '3230' | |
- '3231' | |
- '3232' | |
- '3233' | |
- '3234' | |
- '3235' | |
- '3236' | |
- '3237' | |
- '3238' | |
- '3239' | |
- '3240' | |
- '3241' | |
- '3242' | |
- '3243' | |
- '3244' | |
- '3245' | |
- '3246' | |
- '3247' | |
- '3248' | |
- '3249' | |
- '3250' | |
- '3251' | |
- '3252' | |
- '3253' | |
- '3254' | |
- '3255' | |
- '3256' | |
- '3257' | |
- '3258' | |
- '3259' | |
- '3260' | |
- '3261' | |
- '3262' | |
- '3263' | |
- '3264' | |
- '3265' | |
- '3266' | |
- '3267' | |
- '3268' | |
- '3269' | |
- '3270' | |
- '3271' | |
- '3272' | |
- '3273' | |
- '3274' | |
- '3275' | |
- '3276' | |
- '3277' | |
- '3278' | |
- '3279' | |
- '3280' | |
- '3281' | |
- '3282' | |
- '3283' | |
- '3284' | |
- '3285' | |
- '3286' | |
- '3287' | |
- '3288' | |
- '3289' | |
- '3290' | |
- '3291' | |
- '3292' | |
- '3293' | |
- '3294' | |
- '3295' | |
- '3296' | |
- '3297' | |
- '3298' | |
- '3299' | |
- '3351' | |
- '3352' | |
- '3353' | |
- '3354' | |
- '3355' | |
- '3356' | |
- '3357' | |
- '3358' | |
- '3359' | |
- '3360' | |
- '3361' | |
- '3362' | |
- '3363' | |
- '3364' | |
- '3365' | |
- '3366' | |
- '3367' | |
- '3368' | |
- '3369' | |
- '3370' | |
- '3371' | |
- '3372' | |
- '3373' | |
- '3374' | |
- '3375' | |
- '3376' | |
- '3377' | |
- '3378' | |
- '3379' | |
- '3380' | |
- '3381' | |
- '3382' | |
- '3383' | |
- '3384' | |
- '3385' | |
- '3386' | |
- '3387' | |
- '3388' | |
- '3389' | |
- '3390' | |
- '3391' | |
- '3392' | |
- '3393' | |
- '3394' | |
- '3395' | |
- '3396' | |
- '3397' | |
- '3398' | |
- '3399' | |
- '3400' | |
- '3401' | |
- '3402' | |
- '3403' | |
- '3404' | |
- '3405' | |
- '3406' | |
- '3407' | |
- '3408' | |
- '3409' | |
- '3410' | |
- '3411' | |
- '3412' | |
- '3413' | |
- '3414' | |
- '3415' | |
- '3416' | |
- '3417' | |
- '3418' | |
- '3419' | |
- '3420' | |
- '3421' | |
- '3422' | |
- '3423' | |
- '3424' | |
- '3425' | |
- '3426' | |
- '3427' | |
- '3428' | |
- '3429' | |
- '3430' | |
- '3431' | |
- '3432' | |
- '3433' | |
- '3434' | |
- '3435' | |
- '3436' | |
- '3437' | |
- '3438' | |
- '3439' | |
- '3440' | |
- '3441' | |
- '3501' | |
- '3502' | |
- '3503' | |
- '3504' | |
- '3505' | |
- '3506' | |
- '3507' | |
- '3508' | |
- '3509' | |
- '3510' | |
- '3511' | |
- '3512' | |
- '3513' | |
- '3514' | |
- '3515' | |
- '3516' | |
- '3517' | |
- '3518' | |
- '3519' | |
- '3520' | |
- '3521' | |
- '3522' | |
- '3523' | |
- '3524' | |
- '3525' | |
- '3526' | |
- '3527' | |
- '3528' | |
- '3529' | |
- '3530' | |
- '3531' | |
- '3532' | |
- '3533' | |
- '3534' | |
- '3535' | |
- '3536' | |
- '3537' | |
- '3538' | |
- '3539' | |
- '3540' | |
- '3541' | |
- '3542' | |
- '3543' | |
- '3544' | |
- '3545' | |
- '3546' | |
- '3547' | |
- '3548' | |
- '3549' | |
- '3550' | |
- '3551' | |
- '3552' | |
- '3553' | |
- '3554' | |
- '3555' | |
- '3556' | |
- '3557' | |
- '3558' | |
- '3559' | |
- '3560' | |
- '3561' | |
- '3562' | |
- '3563' | |
- '3564' | |
- '3565' | |
- '3566' | |
- '3567' | |
- '3568' | |
- '3569' | |
- '3570' | |
- '3571' | |
- '3572' | |
- '3573' | |
- '3574' | |
- '3575' | |
- '3576' | |
- '3577' | |
- '3578' | |
- '3579' | |
- '3580' | |
- '3581' | |
- '3582' | |
- '3583' | |
- '3584' | |
- '3585' | |
- '3586' | |
- '3587' | |
- '3588' | |
- '3589' | |
- '3590' | |
- '3591' | |
- '3592' | |
- '3593' | |
- '3594' | |
- '3595' | |
- '3596' | |
- '3597' | |
- '3598' | |
- '3599' | |
- '3600' | |
- '3601' | |
- '3602' | |
- '3603' | |
- '3604' | |
- '3605' | |
- '3606' | |
- '3607' | |
- '3608' | |
- '3609' | |
- '3610' | |
- '3611' | |
- '3612' | |
- '3613' | |
- '3614' | |
- '3615' | |
- '3616' | |
- '3617' | |
- '3618' | |
- '3619' | |
- '3620' | |
- '3621' | |
- '3622' | |
- '3623' | |
- '3624' | |
- '3625' | |
- '3626' | |
- '3627' | |
- '3628' | |
- '3629' | |
- '3630' | |
- '3631' | |
- '3632' | |
- '3633' | |
- '3634' | |
- '3635' | |
- '3636' | |
- '3637' | |
- '3638' | |
- '3639' | |
- '3640' | |
- '3641' | |
- '3642' | |
- '3643' | |
- '3644' | |
- '3645' | |
- '3646' | |
- '3647' | |
- '3648' | |
- '3649' | |
- '3650' | |
- '3651' | |
- '3652' | |
- '3653' | |
- '3654' | |
- '3655' | |
- '3656' | |
- '3657' | |
- '3658' | |
- '3659' | |
- '3660' | |
- '3661' | |
- '3662' | |
- '3663' | |
- '3664' | |
- '3665' | |
- '3666' | |
- '3667' | |
- '3668' | |
- '3669' | |
- '3670' | |
- '3671' | |
- '3672' | |
- '3673' | |
- '3674' | |
- '3675' | |
- '3676' | |
- '3677' | |
- '3678' | |
- '3679' | |
- '3680' | |
- '3681' | |
- '3682' | |
- '3683' | |
- '3684' | |
- '3685' | |
- '3686' | |
- '3687' | |
- '3688' | |
- '3689' | |
- '3690' | |
- '3691' | |
- '3692' | |
- '3693' | |
- '3694' | |
- '3695' | |
- '3696' | |
- '3697' | |
- '3698' | |
- '3699' | |
- '3700' | |
- '3701' | |
- '3702' | |
- '3703' | |
- '3704' | |
- '3705' | |
- '3706' | |
- '3707' | |
- '3708' | |
- '3709' | |
- '3710' | |
- '3711' | |
- '3712' | |
- '3713' | |
- '3714' | |
- '3715' | |
- '3716' | |
- '3717' | |
- '3718' | |
- '3719' | |
- '3720' | |
- '3721' | |
- '3722' | |
- '3723' | |
- '3724' | |
- '3725' | |
- '3726' | |
- '3727' | |
- '3728' | |
- '3729' | |
- '3730' | |
- '3731' | |
- '3732' | |
- '3733' | |
- '3734' | |
- '3735' | |
- '3736' | |
- '3737' | |
- '3738' | |
- '3739' | |
- '3740' | |
- '3741' | |
- '3742' | |
- '3743' | |
- '3744' | |
- '3745' | |
- '3746' | |
- '3747' | |
- '3748' | |
- '3749' | |
- '3750' | |
- '3751' | |
- '3752' | |
- '3753' | |
- '3754' | |
- '3755' | |
- '3756' | |
- '3757' | |
- '3758' | |
- '3759' | |
- '3760' | |
- '3761' | |
- '3762' | |
- '3763' | |
- '3764' | |
- '3765' | |
- '3766' | |
- '3767' | |
- '3768' | |
- '3769' | |
- '3770' | |
- '3771' | |
- '3772' | |
- '3773' | |
- '3774' | |
- '3775' | |
- '3776' | |
- '3777' | |
- '3778' | |
- '3779' | |
- '3780' | |
- '3781' | |
- '3782' | |
- '3783' | |
- '3784' | |
- '3785' | |
- '3786' | |
- '3787' | |
- '3788' | |
- '3789' | |
- '3790' | |
- '3816' | |
- '3835' | |
- '4011' | |
- '4111' | |
- '4112' | |
- '4119' | |
- '4121' | |
- '4131' | |
- '4214' | |
- '4215' | |
- '4225' | |
- '4411' | |
- '4457' | |
- '4468' | |
- '4511' | |
- '4582' | |
- '4722' | |
- '4723' | |
- '4784' | |
- '4789' | |
- '4812' | |
- '4814' | |
- '4815' | |
- '4816' | |
- '4821' | |
- '4829' | |
- '4899' | |
- '4900' | |
- '5013' | |
- '5021' | |
- '5039' | |
- '5044' | |
- '5045' | |
- '5046' | |
- '5047' | |
- '5051' | |
- '5065' | |
- '5072' | |
- '5074' | |
- '5085' | |
- '5094' | |
- '5099' | |
- '5111' | |
- '5122' | |
- '5131' | |
- '5137' | |
- '5139' | |
- '5169' | |
- '5172' | |
- '5192' | |
- '5193' | |
- '5198' | |
- '5199' | |
- '5200' | |
- '5211' | |
- '5231' | |
- '5251' | |
- '5261' | |
- '5271' | |
- '5300' | |
- '5309' | |
- '5310' | |
- '5311' | |
- '5331' | |
- '5399' | |
- '5411' | |
- '5422' | |
- '5441' | |
- '5451' | |
- '5462' | |
- '5499' | |
- '5511' | |
- '5521' | |
- '5531' | |
- '5532' | |
- '5533' | |
- '5541' | |
- '5542' | |
- '5551' | |
- '5561' | |
- '5571' | |
- '5592' | |
- '5598' | |
- '5599' | |
- '5611' | |
- '5621' | |
- '5631' | |
- '5641' | |
- '5651' | |
- '5655' | |
- '5661' | |
- '5681' | |
- '5691' | |
- '5697' | |
- '5698' | |
- '5699' | |
- '5712' | |
- '5713' | |
- '5714' | |
- '5718' | |
- '5719' | |
- '5722' | |
- '5732' | |
- '5733' | |
- '5734' | |
- '5735' | |
- '5811' | |
- '5812' | |
- '5813' | |
- '5814' | |
- '5815' | |
- '5816' | |
- '5817' | |
- '5818' | |
- '5832' | |
- '5912' | |
- '5921' | |
- '5931' | |
- '5932' | |
- '5933' | |
- '5935' | |
- '5937' | |
- '5940' | |
- '5941' | |
- '5942' | |
- '5943' | |
- '5944' | |
- '5945' | |
- '5946' | |
- '5947' | |
- '5948' | |
- '5949' | |
- '5950' | |
- '5960' | |
- '5961' | |
- '5962' | |
- '5963' | |
- '5964' | |
- '5965' | |
- '5966' | |
- '5967' | |
- '5968' | |
- '5969' | |
- '5970' | |
- '5971' | |
- '5972' | |
- '5973' | |
- '5975' | |
- '5976' | |
- '5977' | |
- '5978' | |
- '5983' | |
- '5992' | |
- '5993' | |
- '5994' | |
- '5995' | |
- '5996' | |
- '5997' | |
- '5998' | |
- '5999' | |
- '6010' | |
- '6011' | |
- '6012' | |
- '6051' | |
- '6211' | |
- '6300' | |
- '6381' | |
- '6399' | |
- '6513' | |
- '7011' | |
- '7012' | |
- '7032' | |
- '7033' | |
- '7210' | |
- '7211' | |
- '7216' | |
- '7217' | |
- '7221' | |
- '7230' | |
- '7251' | |
- '7261' | |
- '7273' | |
- '7276' | |
- '7277' | |
- '7278' | |
- '7296' | |
- '7297' | |
- '7298' | |
- '7299' | |
- '7311' | |
- '7321' | |
- '7332' | |
- '7333' | |
- '7338' | |
- '7339' | |
- '7342' | |
- '7349' | |
- '7361' | |
- '7372' | |
- '7375' | |
- '7379' | |
- '7392' | |
- '7393' | |
- '7394' | |
- '7395' | |
- '7399' | |
- '7511' | |
- '7512' | |
- '7513' | |
- '7519' | |
- '7523' | |
- '7531' | |
- '7534' | |
- '7535' | |
- '7538' | |
- '7542' | |
- '7549' | |
- '7622' | |
- '7623' | |
- '7629' | |
- '7631' | |
- '7641' | |
- '7692' | |
- '7699' | |
- '7800' | |
- '7801' | |
- '7802' | |
- '7829' | |
- '7832' | |
- '7841' | |
- '7911' | |
- '7922' | |
- '7929' | |
- '7932' | |
- '7933' | |
- '7941' | |
- '7991' | |
- '7992' | |
- '7993' | |
- '7994' | |
- '7995' | |
- '7996' | |
- '7997' | |
- '7998' | |
- '7999' | |
- '8011' | |
- '8021' | |
- '8031' | |
- '8041' | |
- '8042' | |
- '8043' | |
- '8044' | |
- '8049' | |
- '8050' | |
- '8062' | |
- '8071' | |
- '8099' | |
- '8111' | |
- '8211' | |
- '8220' | |
- '8241' | |
- '8244' | |
- '8249' | |
- '8299' | |
- '8351' | |
- '8398' | |
- '8641' | |
- '8651' | |
- '8661' | |
- '8675' | |
- '8699' | |
- '8734' | |
- '8911' | |
- '8931' | |
- '8999' | |
- '9211' | |
- '9222' | |
- '9223' | |
- '9311' | |
- '9399' | |
- '9402' | |
- '9405' | |
- '9700' | |
- '9701' | |
- '9702' | |
- '9950' | |
x-finix-issues: | |
- property2 | |
description: 'The Merchant Category Code of the `Merchan. ' | |
default_sender_account_number: | |
type: string | |
description: The default account of the sender. | |
nullable: true | |
default_sender_address: | |
type: string | |
description: The sender’s address. | |
nullable: true | |
default_sender_city: | |
type: string | |
description: The city saved in the sender's address. | |
nullable: true | |
default_sender_country: | |
$ref: '#/components/schemas/Country' | |
default_sender_country_code: | |
type: string | |
description: The sender's 3 letter ISO 4217 currency code. | |
nullable: true | |
default_sender_county_code: | |
type: string | |
description: The sender’s county. | |
nullable: true | |
default_sender_name: | |
type: string | |
description: The sender’s name. | |
nullable: true | |
default_sender_state_code: | |
type: string | |
description: The sender's 2-letter State code. | |
nullable: true | |
default_sender_zip_code: | |
type: string | |
description: The sender’s zip code. | |
nullable: true | |
include_colombia_data: | |
type: boolean | |
description: Must be true if transactions are in Colombia where there are different fees. | |
moto_eciindicator: | |
type: string | |
enum: | |
- '5' | |
- '6' | |
- '7' | |
- '8' | |
x-finix-issues: | |
- property2 | |
description: Identifies the level of security used in an electronic commerce transaction (only applies to card-present transactions). | |
pan_entry_mode: | |
type: string | |
enum: | |
- '00' | |
- '01' | |
- '02' | |
- '03' | |
- '04' | |
- '05' | |
- '06' | |
- '07' | |
- '08' | |
- '09' | |
- '10' | |
- '80' | |
- '82' | |
- '83' | |
- '90' | |
- '91' | |
- '95' | |
x-finix-issues: | |
- property2 | |
description: A 2-digit code that identifies the method used to enter the cardholder account number and card expiration date (only applies to card-present transactions). | |
pos_condition_code: | |
type: string | |
enum: | |
- '00' | |
- '01' | |
- '02' | |
- '03' | |
- '05' | |
- '06' | |
- '08' | |
- '10' | |
- '51' | |
- '59' | |
- '71' | |
- '73' | |
x-finix-issues: | |
- property2 | |
description: Contains a code identifying transaction conditions at the point of sale or point of service (only applies to card-present transactions). | |
config: | |
type: object | |
description: 'Configure how the `Processor` handles transaction details, specifc to the processor.' | |
nullable: true | |
properties: | |
canDebitBankAccount: | |
type: boolean | |
description: Details if the `Application` can debit bank accounts using the `Processor`. | |
default_merchant_profile: | |
type: string | |
description: The ID of the `Merchant Profile` resource used to create the `Processor`. | |
enabled: | |
type: boolean | |
description: Details if the `Processor` resource is enabled. Set to **false** to disable the `Processor`. | |
processor: | |
type: string | |
description: The name of the processor. | |
system_config: | |
type: object | |
description: Details that configure how the `Processor` handles transactions with the processor. | |
nullable: true | |
properties: | |
acquirer_country_code: | |
type: string | |
enum: | |
- '004' | |
- '008' | |
- '010' | |
- '012' | |
- '016' | |
- '020' | |
- '024' | |
- '028' | |
- '031' | |
- '032' | |
- '036' | |
- '040' | |
- '044' | |
- '048' | |
- '050' | |
- '051' | |
- '052' | |
- '056' | |
- '060' | |
- '064' | |
- '068' | |
- '070' | |
- '072' | |
- '074' | |
- '076' | |
- '084' | |
- '086' | |
- '090' | |
- '092' | |
- '096' | |
- '100' | |
- '104' | |
- '108' | |
- '112' | |
- '116' | |
- '120' | |
- '124' | |
- '132' | |
- '136' | |
- '140' | |
- '144' | |
- '148' | |
- '152' | |
- '156' | |
- '158' | |
- '162' | |
- '166' | |
- '170' | |
- '174' | |
- '175' | |
- '178' | |
- '180' | |
- '184' | |
- '188' | |
- '191' | |
- '192' | |
- '196' | |
- '203' | |
- '204' | |
- '208' | |
- '212' | |
- '214' | |
- '218' | |
- '222' | |
- '226' | |
- '231' | |
- '232' | |
- '233' | |
- '234' | |
- '238' | |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment