Overview

This guide provides an overview of all available API endpoints for your gateway integration with FlexFactor.

Authentication

endpointlink to documentation
POST /oauth2/tokenRetrieve an access token




Payment endpoints

The transactions APIs are used in different levels of the payment activities and interactions.




Orders endpoints

Use Order APIs to manage orders that were processed through FlexFactor.

endpointlink to documentation
GET /v1/orders/Retrieve the status of multiple orders at once.
GET /v1/orders/{id}Retrieve the status on a specific order.
POST /v1/orders/{id}/refundIssue partial or total refunds for a specific order.
POST /v1/orders/{id}/cancelCancel a pending order.


Merchant Onboarding

Programmatically onboard a merchant on FlexFactor services.


Application endpoints

Use the Application APIs to create and manage application forms on behalf of merchants.

endpointlink to documentation
POST /v1/onboarding/applicationCreate a new applicant
GET /v1/onboarding/application/{id}Retrieve the details on a specific application.
PUT /v1/onboarding/application/{id}Edit the details of a specific application
POST /v1/onboarding/application/{id}/submitSend an application for underwriting review
GET /v1/onboarding/application/listRetrieve the status of multiple applications
POST /v1/onboarding/application/{id}/cancelCancel a pending application


Document Management Endpoints

Use the Documents APIs to attach and manage application documents.

endpointlink to documentation
POST /v1/onboarding/application/{id}/documents/Attach a document to an application.
GET /v1/onboarding/application/{id}/documents/Retrieve all documents attached to a specific application.
GET /v1/onboarding/application/{id}/documents/{documentID}Retrieve the list of documents attached to an application.
DELETE /v1/onboarding/application/{id}/documents/{documentID}Delete a document associated with an application.



Merchants Endpoints

Merchant details include comprehensive metadata about merchants, such as their company information, contact details, banking information, and associated sites.

endpointlink to Documentation
GET /v1/merchants/{mid}Retrieve the details of a specific merchant.
GET /v1/merchantsRetrieve a list of onboarded merchants.



API Keys Endpoints

You can create, view, manage, and delete API keys on behalf of your merchants. Store them securely to authenticate your merchants when using the FlexFactor APIs

endpointlink to documentation
POST /v1/api-keysCreate an API key
GET /v1/api-keys/{id}Get an API key
GET /v1/api-keys/{mid}Retrieve all the API keys related to a merchant
DELETE /v1/api-keys/{id}Revoke an API key


Webhooks




Testing scenarios

Use our whitelisted testing cards for your testing scenarios .




System Health

endpointlink to documentation
GET /v1/healthCheck the health and availability of the API services.