Create or replay a partner-local user
Creates a tenant-local user record for a partner credential without
creating a Core/Fineract customer. This lets partners test identity,
consent, audit, and subject-link readiness before any mobile UI or
credit-execution workflow is involved. Requires the users:write
partner scope. X-Tenant-Id and X-Partner-Code are cross-checks;
the credential remains the source of truth for tenant access.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
Create or replay a partner-local user › Request Body
partnerUserRefpartnerCustomerRefOptional partner customer reference when the partner separates users from customers.
sourceChannelcountryCodephoneE164^\+\d{8,15}$Non-secret identity evidence captured by the partner.
Optional flat partner metadata for audit and support.
Create or replay a partner-local user › Responses
Partner-local user created or replayed idempotently
Get a partner-local user
Returns the tenant-local user record created by the partner. This read
does not require a mobile registration or a Core/Fineract customer link.
Requires the users:read partner scope.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
partnerUserRefUser reference from the partner system.
Get a partner-local user › Responses
Partner-local user status
Link a partner customer reference to a Core customer
Creates or replays a partner-local customer reference against an existing
canonical Core customer. This endpoint does not create Fineract
customers; mobile/POS/Core registration remains the source of truth.
Requires the customers:write partner scope.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
Link a partner customer reference to a Core customer › Request Body
partnerCustomerRefcustomerIdExisting canonical Core customer ID.
phoneE164^\+\d{8,15}$Existing customer phone in Core mapping.
Optional flat partner metadata for audit and support.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: customerId | |
| type = object · requires: phoneE164 |
customerIdExisting canonical Core customer ID.
partnerCustomerRefphoneE164^\+\d{8,15}$Existing customer phone in Core mapping.
Optional flat partner metadata for audit and support.
Link a partner customer reference to a Core customer › Responses
Partner customer reference linked to the canonical customer
successGet a partner customer reference
Returns the Core customer link for one partner-local customer reference.
Requires the customers:read partner scope.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
partnerCustomerRefCustomer reference from the partner system.
Get a partner customer reference › Responses
Partner customer reference status
successList a partner customer's credit lines
Returns MobiCred credit lines for an active partner customer mapping.
Requires the credit-lines:read partner scope. X-Partner-Code must
match the partnerCode path parameter.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
partnerCustomerRefCustomer reference from the partner system.
List a partner customer's credit lines › Responses
Credit lines visible to the partner for this customer
successCreate a partner credit application
Creates an idempotent MobiCred NoStress credit application for a mapped
partner customer. Requires the credit-applications:write partner scope
and a unique X-Idempotency-Key per logical application request.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
Headers
X-Idempotency-KeyStable key for replay-safe partner credit application creation.
Create a partner credit application › Request Body
partnerCustomerRefprincipaltermDayspurposeCreate a partner credit application › Responses
Credit application accepted or replayed idempotently
successGet partner credit application status
Returns the latest known status for a partner credit application.
Requires the credit-applications:read partner scope.
path Parameters
partnerCode^[a-z0-9_-]{2,64}$ · requiredLowercase partner code issued by MobiCred.
applicationIdPartner credit application UUID returned by create.
Get partner credit application status › Responses
Current partner credit application status
success