Sponsor Processors

Configuration for the sponsoring card processors and bank partners that connect the institution to the card scheme rails. Each record holds the BIN range, connection credentials and settlement parameters used to route issuance and transactions. Correct setup here is the prerequisite for any card to function on the network.

Workflow

Open Sponsor Processors from the Cards issuing menu.
Create a processor and enter its name and BIN range.
Configure connection credentials and the settlement account.
Set the environment (test or production).
Activate so card products can be bound to this processor.

Fields reference

Every field on this screen, drawn from the live data model.

Field	Type	Required	Description
Provider Code `provider_code`	Choice: Network International, I&M Bank, Equity Bank, NCBA Bank, Generic (bank-agnostic)	Yes	Selects the concrete driver model used to talk to the processor.
Website Messages `website_message_ids`	List	—	Website communication history
Signing Secret `signing_secret`	Text	—	Shared secret used to verify inbound webhook HMACs.
Default BIN `default_bin`	Text	—	First 6-8 digits of cards minted under this sponsor.
Name `name`	Text	Yes	Name
Environment `environment`	Choice: Sandbox, Production	Yes	Environment
Base URL `base_url`	Text	Yes	Base URL
Has Message `has_message`	Yes/No	—	Has Message
Ratings `rating_ids`	List	—	Ratings
Sequence `sequence`	Number	—	Sequence
Company `company_id`	Link → res.company	—	Company
Token Endpoint `token_endpoint`	Text	—	Token Endpoint
Personalisation Endpoint `personalize_endpoint`	Text	—	Personalisation Endpoint
Activation Endpoint `activate_endpoint`	Text	—	Activation Endpoint
Block Endpoint `block_endpoint`	Text	—	Block Endpoint
Hot-List Endpoint `hot_list_endpoint`	Text	—	Hot-List Endpoint
API Key `api_key`	Text	—	API Key
Client ID `client_id`	Text	—	Client ID
Client Secret `client_secret`	Text	—	Client Secret
Callback URL Path `callback_url_path`	Text	—	Callback URL Path
Public Callback URL `callback_url`	Text	—	Public Callback URL
Active `active`	Yes/No	—	Active
Default `is_default`	Yes/No	—	Default
Card Count `card_count`	Number	—	Card Count

Actions & buttons

Buttons available on this screen and what they do:

Test Connection

Notes & rules

Model mfi.card.processor; the scheme/bank sponsor master.
Holds BIN range, API credentials and settlement parameters.
Referenced by card products and the transaction reconciliation flow.
Test vs production toggle governs live card-network calls.

Technical model: mfi.card.processor · Record: Card Sponsor / Issuer Processor