Contents
- Overview and availability
- Configure the integration
- Add the PayU payment type
- Work with PayU in an order
Overview and availability
PayU is a service for managing online payments.
The PayU integration lets you create payment links from orders. When an invoice is paid, the payment status changes automatically in Simla. If necessary, you can also issue a refund from the order. The link can be sent by SMS, email, chat, or another messaging service.
The integration is available if at least one of the following countries is enabled: Argentina, Colombia, Mexico, Panama, Peru, or Brazil.
The currency configured in PayU must match the currency selected in Simla.
Configure the integration
Prerequisites and API key
To connect PayU, you need a created and verified PayU account. Complete the company, bank, and other required details. The account can be connected to Simla after the contract has been signed and the live account has been activated.
Before connecting PayU, open your Simla account, for example, https://yourstore.simla.com, and go to Settings → Integration → API access keys. Create an application programming interface (API) key, select the store, and enable the following methods:
Integration:
/api/integration-modules/{code}/api/integration-modules/{code}/edit
Payments:
/api/payment/create-invoice/api/payment/(updateInvoice|check)
Connect and configure a PayU account
In the Simla Marketplace, select PayU and click Connect. On the connection page, enter your Simla account URL, the API key created earlier, and the integration language.
After saving the connection details, open the Accounts section and enter the Name, Merchant ID, Account ID, API login, API Key, and language to add an account.
Note
The Merchant ID, Account ID, API login, and API Key are available in PayU under Technical configuration → Payments.
After entering the credentials, click Save. The updated page displays the connected account and store name.
The Test field is informational and is configured in PayU. It indicates whether the test or production account is being used. Below the connected accounts table, a link opens the payment method settings in Simla.
Add the PayU payment type
After connecting PayU, go to Settings → Data books → Payment types and click Add to create a payment type.
In the Integrate with field, select the PayU account connected earlier. This link cannot be changed after the payment type is saved. Create a separate payment type for each connected store.
Configure invoice statuses
When a payment method is connected for the first time, configure the invoice status mapping. The same settings are applied by default to payment modules connected later, but they can be edited.
Click Configure in the Invoice statuses section to open the status mapping window.
If the existing statuses do not match the company's process, select the status to map, click Add new payment status, enter a name, and confirm it. Statuses created from this window are also available in the Payment statuses section.
Work with PayU in an order
After the integration is configured, the PayU payment type is available in the Payments block of the order.
Generate and send a payment link
After saving the order, you can generate a payment link. The following information and actions are then displayed:
- Link to pay: can be copied and sent to the customer in a chat.
- Send to email: sends the link to the email address specified in the order.
- Sum: total amount to be paid.
- Creation date: date when the link was generated.
- Invoice status: updates automatically when the payment is completed.
- Cancel: cancels the link.
- Status: updates automatically according to the configured status mapping.
- Paid date: date when the payment was completed.
Payment and refund
When the customer opens the link, PayU displays the payment page.
After a successful payment, its status is updated in the order according to the configured mapping. The Sum and Paid date fields also show the updated data.
To issue a refund, click Make a refund in the order.
After the refund is confirmed, the invoice status is updated automatically.