SimpliFi - Aion
HomeContact Us
HomeContact Us
    • Introduction
    • SimpliFi Architecture
    • SimpliFi Virtual Card SDK Integration Guide
    • Webhook Signature
    • Auth
      • Login to generate JWT token
        POST
      • Login to generate SDK Admin JWT token
        POST
    • Card Program
      • Create Card Program
        POST
      • Get Card Program
        GET
      • Change Card Program Status
        PATCH
      • Link Funding Source to Card Program
        POST
      • Get Balance of Funding Source
        GET
      • Transfer funds from one Card Program to other
        POST
      • Raise Funding
        POST
      • Raise Funding Document Upload
        POST
      • Funding Source Statement
        GET
    • User
      • Upload Document
        POST
      • List all Users
        GET
      • Create a User
        POST
      • Retrieve a User
        GET
      • Update a User
        PUT
      • Delete a User
        DELETE
      • Add update address of user
        POST
    • Card
      • Get Card Statement
        GET
      • List all Cards
        GET
      • Create a Card
        POST
      • Get Card Details
        GET
      • Retrieve Balance on the Card
        GET
      • Activate a Card
        POST
      • Manage Card Status
        POST
      • Load a Card
        POST
      • Unload a Card
        POST
      • Renewal of the Card
        POST
      • Request a Physical Card
        POST
      • Get Rule Groups on Card
        GET
      • Create Rule Group on Card
        POST
      • Update Rule Group on Card
        PUT
      • Delete Rule Group on Card
        DELETE
      • Apply Rule Group on Card
        POST
      • Remove Rule Group on Card
        DELETE
    • Transaction
      • List All Transactions
    • Fee
      • Add fee configuration
      • Fetch fee config
      • Change the status of fee config
      • Add Fee event against card uuid in queue
      • Apply fee against card uuid present in queue
    • Webhook
      • Get all events
      • Create a webhook
      • Update a Webhook
      • Delete a Webhook
      • Updates the status of Webhook
      • Card Activation webhook
      • Card Issuance webhook
      • Card PIN Setup webhook
      • Card Renewed webhook
      • Card Status Change webhook
      • Card Type Change webhook
      • Card Load webhook
      • Card Unload webhook
      • Card -to- Card Transfer webhook
      • User create webhook
      • User update webhook
      • User delete webhook
      • Card Program Create webhook
      • Funds transfer webhook
      • Raise funding webhook
      • Transaction webhook
      • Transaction Enrichment webhook
      • Fee apply webhook
      • Rule group create webhook
      • Rule group update webhook
      • Rule group delete webhook
      • Wallet rule group create webhook
      • Wallet rule group delete webhook
      • Card rule group create webhook
      • Card rule group delete webhook
    • Schemas
      • ErrorModel
      • AuthRequestModel
      • SdkAuthRequestModel
      • AuthResponseModel
      • CardProgramRequestModel
      • CardConfigModel
      • CardPoi
      • CardProgramResponseModel
      • FundingSourceBalanceModel
      • CardProgramTransferFundsModel
      • FundingSourceRequestModel
      • FundingSourceResponseModel
      • CardProgramStatusChangeRequestModel
      • RaiseFundingRequestModel
      • RaiseFundingResponseModel
      • StatementResponse
      • CardStatementResponse
      • StatementResponseDetails
      • TransactionRequestModel
      • TransactionResponse
      • TransactionResponseDetails
      • RuleGroupResponseModel
      • RuleGroupModel
      • RuleGroupTransactionRestrictions
      • RuleGroupMerchantRules
      • RuleGroupLoadRestrictions
      • RuleGroupSpendRestrictions
      • RaiseFundingDocumentModel
      • FileUploadModel
      • DocumentUploadModel
      • DocumentModel
      • UserRequestModel
      • UserDetailModel
      • AddressModel
      • AddressRequestModel
      • ContactModel
      • UserModel
      • CardRequestModel
      • CardResponseModel
      • CardRenewalModel
      • InstrumentType
      • AmountModel
      • CardStatusModel
      • CardAmountModel
      • FeesSetupModel
      • FeeConfigurationModel
      • FeesSetupBaseModel
      • FeesSetupRequestModel
      • FeeConfigurationBaseModel
      • FeeConfigurationRequestModel
      • FeeAmountConfigRequestModel
      • FeesSetupResponseModel
      • FeeConfigurationResponseModel
      • FeeAmountConfigResponseModel
      • FeesStatusUpdateModel
      • FeesApplicationCardRequest
      • FeeApplicationEventResponse
      • ApplyFeesOnCardRequest
      • WebhookEventType
      • WebhookEventModel
      • WebhookRequestModel
      • WebhookResponseModel
      • Webhook
      • CompanyUuidParameter
      • RequestUuidParameter
      • UserUuidParameter
      • CardUuidParameter
      • MaskedPanParameter
      • CardStatusParameter
      • TransactionIdParameter
      • TransactionUuidParameter
      • TransactionTypeParameter
      • CardActivationWebhook
      • CardIssuanceWebhook
      • CardPinSetupWebhook
      • CardRenewedWebhook
      • CardStatusChangeWebhook
      • CardTypeChangeWebhook
      • CardLoadWebhook
      • CardUnloadWebhook
      • CardToCardTransferWebhook
      • UserWebhook
      • CardHolderCreationWebhook
      • CardHolderUpdationWebhook
      • CardHolderDeletionWebhook
      • CardProgramCreationWebhook
      • FundTransferWebhook
      • RaiseFundingWebhook
      • TransactionWebhook
      • TransactionEnrichmentWebhook
      • FeesApplyWebhook
      • RuleGroupCreationWebhook
      • RuleGroupUpdationWebhook
      • RuleGroupDeletionWebhook
      • WalletRuleGroupCreationWebhook
      • WalletRuleGroupDeletionWebhook
      • CardRuleGroupCreationWebhook
      • CardRuleGroupDeletionWebhook
      • Error99997
      • Error40089
      • Error40065
      • Error40007
      • Error40056
      • Error30003
      • Error15017
      • Error40081
      • Error30022
      • Error15015
      • Error15016
      • Error30049
      • Error40006
      • Error40010
      • Error40080
      • Error40053
      • Error40113
      • Error40067
      • Error40069
      • Error50010
      • Error50011
      • Error50008
      • Error50004
      • Error10003
      • Error20046
      • Error35004
      • Error35005
      • Error35006
      • Error35007
      • Error35009
      • Error10001
      • Error20133
      • Error20017
      • Error20001
      • Error20005
      • Error20039
      • Error20011
      • Error20038
      • Error20127
      • Error20018
      • Error20002
      • Error20004
      • Error20006
      • Error20032
      • Error30012
      • Error20086
      • Error20019
      • Error20132
      • Error20008
      • Error40054
      • Error20015
      • Error20074
      • Error21090
      • Error20161
      • Error20162
      • Error20089
      • Error20076
      • Error30023
      • Error30013
      • Error20087
      • Error30028
      • Error20070
      • Error20050
      • Error82028
      • Error30004
      • Error30044
      • Error30001
      • Error30006
      • Error30048
      • Error30024
      • Error35043
      • Error30025
      • Error30010
      • Error30047
      • ErrorReason99997
      • Error81040
      • Error40128
      • Error40136
      • Error10035
      • Error35024
      • Error60001
      • Error60002
      • Error60003
      • Error60004
      • Error60005
      • Error60021
      • Error60012
      • Error60009

    SimpliFi Architecture

    SimpliFi uses Async architecture to let the clients use its APIs in a modular set-up. Every API call made to SimpliFi
    would result in response code in the 2xx series, if the request was successfully received. Once the request is
    received it gets handled internally to get it processed.
    Once the request is processed, the response of the request is provided to the clients at their configurable endpoints
    through webhooks. Webhook body would provide appropriate values in case the request was completed as well as error
    codes in case the request resulted in failure.
    CardProduct: This is the highest level of the resource hierarchy with-in SimpliFi platform. CardProduct are
    implemented at the partnering processors depending upon client requirements and approvals from regulatory bodies
    and schemes. CardProduct implementation once completed would return a CardProgramTemplateUUID which can be
    used to create card programs.
    Funding Source: Every client (or company i.e. client of SimpliFi client) would get a dedicated funding source
    in each approved currencies for CardProduct. One funding source can be linked with multiple Cards Products or
    Card Programs. Funding source is the Account number that is created to specifically run the card programs created
    under a Company.
    CardProgram: These are configured templates and define the unique use case per client. These can also be
    configured and provided dedicated names to identify unique company in case the SimpliFi client is not the end
    client issuing the cards to its customers. Any client can have multiple Card Program using the same template
    (product type) or different template (product type).
    User: Users are cardholders to whom the cards would be issued. Users can be created using APIs. At the time of
    user creation; users are assigned under a card program. During card issuance for the users the cardprogram can be
    overwritten by providing a different card program as an input. If card program as an input during card issuance is
    not provided then the default card program used during user creation can be used.
    Card: These are payment cards which can be issued in virtual or physical form and can be used to conduct
    transactions. One user can have multiple cards.
    Wallet/Currency: SimpliFi supports multi currency environment. Currently the SimpliFi platform
    supports 50+ currencies. If the card requires more than one currency on the card, a dedicated wallet would be
    created supporting each currency. Supported currencies are listed below.
    PCI DSS Compliant SDK: Both iOS and Android SDKs which can be wrapped under client App to enable
    cardholders access their card details on the app.
    Transactions: Transactions on SimpliFi platform could be accessed using two mechanisms:
    API: The API can be called to see all the transactions at Card, User or Card Program level. However
    this API would not be enough to update the client system with real time transactions.
    Webhook: To support clients update their system with real time transactions (which the card holders would
    be conducting outside of their system), SimpliFi would send the webhooks with all the transactional details.

    Supported Currencies#

    AED
    BHD
    SAR
    JOD
    KWD
    OMR
    QAR
    AUD
    CAD
    EUR
    GBP
    USD
    HKD

    Getting API Keys#

    To request API keys for the SimpliFi platform please place a request here. Once
    we receive your request we’d be able to send you:
    Client ID
    User ID
    Temporary Password
    Dummy funding source in USD currency
    CardProgramTemplateUUID
    You will be able to use the first three credentials to start testing APIs (or access SimpliFi Portal). You can use
    the dummy funding source to link it with the card programs you would have created. We would also be setting up
    a CardProgramTemplateUUID for you to start creating a card program.
    Modified at 2026-08-12 06:22:38
    Previous
    Introduction
    Next
    SimpliFi Virtual Card SDK Integration Guide
    Built with