PayU Panama

PayU Panama has some special integration requirements. Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.

Creating a Provider Configuration

When creating a new provider configuration in the PaymentsOS Control Center, select PayU Latam as the provider.

Specifications for Card-based Transactions

The following table lists the integration specifications for PayU Panama.

Specifications	Details
Minimum PaymentsOS API Version	1.0.0
Requests	Charge Refund Limitations: Partial Refund is not supported. The PaymentsOS test environment does not support the requests listed (this is a limitation of the PayU Latam sandbox environment).
Currencies	USD
Payment Methods	MASTERCARD
Transaction Processing without CVV	Not supported
3DS Redirection	Not supported

Configurations

The following table lists the configurations that are specific to PayU Panama.

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

Sample Requests

Use the bodybuilder to create a sample request body for each request type.

Testing

Follow the steps in the PayU integration testing page.

The transaction may be declined with the following responseCode: DECLINED_TEST_MODE_NOT_ALLOWED. For testing, try one of these workarounds:

When creating the Token, set the token.holder_name to "APPROVED".
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.