Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.
- API Version
- Payment Methods
- Setup Procedures
- Integration Procedures
Minimum required API version: 1.2.0
The following table lists all supported payment methods.
|Payment Method||Payment Method Type|
The following table provides an overview of all supported and non-supported features.
|3DS Data from External MPI||No|
|Level 2 and 3 Data||No|
|Retrieve Supported Payment Methods||No|
|Statement Soft Descriptor||Yes|
|Stored Credentials Flag||No|
|Transaction Processing without CVV||No|
The PaymentsOS test environment does not support charge and refund requests listed (this is a limitation of the PayU Latam sandbox environment).
The following table lists all supported requests. Use the bodybuilder to create a sample request body for each request type.
|Charge||Not Applicable||Asynchronous or Synchronous||The request can be synchronous or asynchronous, depending on your setup.|
|Refund||Partial and multiple are not supported||Asynchronous|
Creating a Provider Configuration
When creating a new provider configuration in the PaymentsOS Control Center, select PayU Latam as the provider.
The following table lists the setup procedures that are specific to this provider.
|In the PaymentsOS Control Center, configure the following credentials: ||Required|
|In the PaymentsOS Control Center, register webhooks to be notified when a transaction changes its status.|
Note: Some API requests in the payment flow may remain in a pending status for some time.
|In your PayU Chile account, enable the validate unique. This will validate that each payment reference sent to the PayU Latam system is unique.||Required|
|Contact PayU Latam Support to get a list of the minimum payment amounts required by the payment methods that you intend to use. |
To avoid unnecessary request failures, we recommend that you include some 'minimum value' validation for the transaction
The following sections list the integration procedures that are specific to this provider.
Handling the Charge Request Response for Cash Transactions
When you send a
post charge request, we will return a charge resource containing a
charge.redirection.url, and a status of 'pending'. Redirect your customer to this URL (the MULTICAJA site). Then follow the steps below:
Once your customer finishes their interaction with the MULTICAJA site, we'll redirect your customer's browser back to your site, using the
merchant_site_url(that you provided in the
post chargerequest). We've included the following URL parameters in the
merchant_site_url, to provide you with the context of the page that you'll need to load:
status(of the charge).
Example - Charge request Pending:
<merchant_site_url> ?payment_id=dd1fbe34-4636-4a61-8cb1-27ac8a175284 &charge_id=aec1c306-e0f7-452b-8fb5-5b34489e9d10 &status=Pending
The status of your charge request may still be 'pending' when we redirect your customer back to your site (while the provider is processing the request).
Example - Charge request Failed:
<merchant_site_url> ?payment_id=dd1fbe34-4636-4a61-8cb1-27ac8a175284 &charge_id=aec1c306-e0f7-452b-8fb5-5b34489e9d10 &error=provider_error
Your customer should choose one of the payment options:
Pay at a MULTICAJA office. Your customer should print the "payment coupon", or copy coupon code, and go to any MULTICAJA office to pay for their purchase, before the expiration date.
Pay online with an electronic bank transfer. This option is only available in the live environment.
When the provider notifies us that your customer has paid, we will update the transaction status. If no payment notification is received by the expiration date, then the transaction will be considered as
Follow the steps in the PayU integration testing page.
The transaction may be declined with the following
DECLINED_TEST_MODE_NOT_ALLOWED. For testing, try one of these workarounds:
When creating the Token, set the
Your test account may be configured in "test mode". To disable it, log into your administrative module https://sandbox.secure.payulatam.com/. Then navigate to Settings tab > Settings Accounts, select the account and check off
"transaction in test mode". Save your settings when done.
You can use the following cards for testing:
|VISA Credit Card||4938590000000017|
|MASTER Credit Card||5435630000000008|
|AMEX Credit Card||377825000000005|
|DINERS Credit Card||36525200000002|