MODO

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

Use Payrails as a payment orchestrator
Use MODO to accept wallet payments in Argentina
Have an active MODO merchant account

Create a MODO 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 Modo.
Continue to the next step.

A screenshot showing MODO selected as the provider.

Step 3: Configure your MODO integration

What you’ll need from MODOBefore you begin, make sure you have your MODO username, password and processor code. MODO provides them when it sets up your account.

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_modo.

A screenshot showing the integration instance name field.

Payment methods

In Payrails

Select Modo.

A screenshot showing the MODO payment method selection.

Credentials

In Payrails

Field	Value
Username	Your MODO username
Password	Your MODO password

Payrails sends requests to the MODO pre-production environment in test mode and to the live environment in live mode, so use the credentials for the matching environment.

A screenshot showing the MODO credential fields.

Account details

In Payrails

Field	Value
Processor Code	Your MODO processor code: the identifier of the payment gateway configuration for your payments
Commercial Condition (CC) Code	Optional. Refer to Configure MODO settings.

A screenshot showing the MODO account details fields.

Webhooks or notifications

Payrails sends its notification URL to MODO with every payment, so you don’t need to set one up with MODO. Payrails verifies each notification with the signing keys MODO publishes and also checks the payment status with MODO until it reaches a final state.

Request fields for MODO

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

Field	Status	Description
`amount`	Required	Use ARS. MODO charges the order total.
`meta.order`	Required	Include `lines` or `total`. Payrails sends `total` as the amount, or adds up the lines, shipping, tax and discount. The order must match `amount`.
`meta.customer.name`, `meta.customer.lastName`	Required	Sent as the customer’s full name.
`meta.customer.email`	Required	Sent as the customer email.
`merchantReference`	Optional	Sent as the external intention ID. Use a new value for every payment.
`meta.order.description`	Optional	Sent as the payment description. Payrails builds one from the lines when you don’t send it.
`meta.order.lines[].description`, `quantity`	Optional	Sent as the items.
`meta.order.deliveryAddress`, `meta.order.billingAddress`	Optional	Sent as the shipping and invoice addresses.
`meta.customer.identityCardNumber`	Optional	Sent as the customer identification.
`meta.customer.birthDate`	Optional	Sent as the customer’s date of birth.
`meta.customer.phone.number`	Optional	Sent as the customer phone.
`meta.customer.reference`	Optional	Sent as the customer ID.

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

Configure MODO settings

Some MODO integration settings change how Payrails processes your payments. The portal shows the same description when you hover over each setting.

Setting	What it does
Commercial Condition (CC) Code	The installment combinations MODO offers your customer at checkout, for example `3CSI` or `3CSI-6CSI-12CCI`. Payrails sends it to MODO unchanged. When it’s empty, MODO offers a single payment (`1CSI`).

Enable the integration

In Payrails

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

Your MODO integration is now ready to process payments.

Next steps

Run a test payment in ARS in the MODO pre-production environment, and pay it with the MODO app.
Verify that:
- Your customer sees the MODO QR code or app link.
- 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 MODO integration in Payrails

Step 1: Choose the integration type

Step 2: Choose the provider