MobiMoney

Who should use this guideThis guide is intended for merchants who:

Use Payrails as a payment orchestrator
Use MobiMoney for card processing in RUB
Have an active MobiMoney merchant account

Create a MobiMoney integration in Payrails

Log in to the Payrails portal.
Go to Settings → Integrations.
Select Add instance to create a new integration configuration.
Select the workspaces where this integration should be available.

About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.

Step 1: Choose the integration type

Select Payment.
Continue to the next step.

Step 2: Choose the provider

Select MobiMoney.
Continue to the next step.

A screenshot showing MobiMoney selected as the provider.

Step 3: Configure your MobiMoney integration

What you’ll need from MobiMoneyBefore you begin, make sure you have your MobiMoney article ID, terminal ID, login, password, cryptogram UUID and public key. MobiMoney provides them.

Integration instance name

An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for different regions, currencies, or business needs. Choose a clear, consistent name, as it is used in routing.

In Payrails

Enter an Instance name for your integration, for example merchant_mobimoney.

A screenshot showing the integration instance name field.

Account details

In Payrails

Field	Value
Article ID	The article ID of your MobiMoney account

A screenshot showing the MobiMoney account details fields.

Credentials

In Payrails

Field	Value
Terminal ID	The ID of your e-store at MobiMoney
Login, Passwd	The login and password MobiMoney gives you for payment requests
Cryptogram UUID	The UUID MobiMoney gives you for card data encryption
Public Key	The public key MobiMoney gives you. Payrails encrypts the card data with it.

Payrails sends requests to the MobiMoney demo environment in test mode and to the live environment in live mode.

A screenshot showing the MobiMoney credential fields.

Payment methods

In Payrails

Select Card.

A screenshot showing the MobiMoney payment method selection.

Payment status updates

Payrails checks the status of each MobiMoney payment until it reaches a final state, so there’s no webhook to set up.

Request fields for MobiMoney

Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to MobiMoney when you include them. For more about meta fields, refer to Meta fields.

Field	Status	Description
`amount`	Required	Sent to MobiMoney in kopecks. Use RUB.
`merchantReference`	Required	Sent as the payment ID.
`meta.customer.reference`	Required	Sent as the payer ID.
`meta.clientContext.ipAddress`	Required	Sent as the payer IP.
`meta.clientContext.acceptHeader`, `userAgent`, `language`, `colorDepth`, `screenHeight`, `screenWidth`, `timeZoneOffset`, `clientType`	Required	Sent as browser details for 3D Secure. `language` must be a valid language tag of up to 8 characters.
`meta.clientContext.javaEnabled`	Optional	Sent as a browser detail.
`meta.customer.phone`, `name`, `lastName`, `country.code`	Optional	Sent as the payer’s phone, name and country.
`meta.order.description`	Optional	Sent as the payment description.
`meta.vendor.reference`, `name`, `address`	Optional	Sent as the sub-merchant code, title, address and phone.

MobiMoney payments are captured straight away, so use instant capture in your workflow.

Enable the integration

In Payrails

Select Save account to enable the integration.
Confirm the integration shows as Enabled.

Your MobiMoney integration is now ready to process payments.

Next steps

Run a test card payment in RUB in the MobiMoney demo environment.
Verify that:
- The payment appears in MobiMoney.
- The payment status updates correctly in Payrails.
Once verified in test mode, repeat the setup in live mode.

→ Continue to: Test a payment

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Create a MobiMoney integration in Payrails

Step 1: Choose the integration type

Step 2: Choose the provider