PayU Panama

Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.

API Version
Payment Methods
Currencies
Features
Requests
Setup Procedures
Testing

API Version

Minimum required API version: 1.0.0

Payment Methods

The following table lists all supported payment methods.

Payment Method	Payment Method Type
MASTERCARD	Cards

Currencies

USD

Features

The following table provides an overview of all supported and non-supported features.

Feature	Supported
3DS 1.0 External	No
3DS 1.0 Internal	No
3DS 2.0 External	No
3DS 2.0 Internal	No
Installments	Yes
Level 2 and 3 Data	No
Retrieve Supported Payment Methods	No
Statement Soft Descriptor	Yes
Stored Credentials Flag	No
Transaction Processing without CVV	No

Requests

The following table lists all supported requests for card-based transactions. Use the bodybuilder to create a sample request body for each request type.

Request	Partial/Multiple	Mode	Notes
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

Setup Procedures

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.

Configuration	Required/Optional
In the PaymentsOS Control Center, configure the following credentials: apiLogin: The user name supplied by PayU Panama apiKey: undefined accountId: The identifier of the account in PayU Panama paymentCountry: PAN merchantId: The merchant ID in PayU Panama When creating a new provider configuration in the PaymentsOS Control Center, select PayU Latam as the provider.	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.	Required
In your PayU Panama 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 `payment.amount` in your system.	Optional

Testing

Follow the steps in the PayU integration testing page.

To test requests in the PayU Latam sandbox environment, make sure your account has been configured to operate in test mode. You can then simulate specific response statuses for each request type, as listed below.

For Authorization and Charge Requests:

To simulate a status of Approved, pass in "holder_name": "APPROVED" in the Create Token request.
To simulate a status of Pending, pass in "holder_name": "PENDING_TRANSACTION_REVIEW" in the Create Token request.
To simulate a status of Failed, pass in "holder_name": "REJECTED" in the Create Token request.

For Capture, Refund and Void requests:

To simulate a successful Capture request, first initiate a successful Authorization request.
To simulate a successful Refund request, first initiate a successful Charge or Capture request.
To simulate a successful Void request, first initiate a successful a successful Authorization request request.

Test Cards

You can use the following cards for testing:

Card	Number
MASTER Credit Card	5455040000000005
VISA Credit Card	4723030000000005