PayU Colombia

PayU Colombia 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 Colombia.

SpecificationsDetails
Minimum PaymentsOS API Version1.0.0
Requests
  • Charge
  • Refund (including partial)
Limitations:
  • Partial refunds require that you send unique partial refund requests.
  • The PaymentsOS test environment does not support the requests listed (this is a limitation of the PayU Latam sandbox environment).
CurrenciesCOP, USD
Payment Methods
  • AMEX
  • DINERS
  • MASTERCARD
  • VISA
Transaction Processing without CVVSupported
3DS RedirectionNot supported

Specifications for Bank Transfer Transactions

The following table lists the integration specifications for PayU Colombia.

SpecificationsDetails
Minimum PaymentsOS API Version1.0.0
RequestsCharge
CurrenciesCOP, USD
Payment MethodsPSE (bank transfers)

Specifications for Cash-based Transactions

The following table lists the integration specifications for PayU Colombia.

SpecificationsDetails
Minimum PaymentsOS API Version1.0.0
RequestsCharge
CurrenciesCOP, USD
Payment Methods
  • BALOTO
  • BANK_REFERENCED. Payment offices: Davivienda, Banco de Bogotá, Bancolombia.
  • EFECTY
  • OTHERS_CASH. Payment offices: PagaTodo, Gana Gana, Gana, Acertemos, Apuestas Cúcuta 75, Su Chance, La Perla, Apuestas Unidas, JER.

Configurations

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

ConfigurationRequired/Optional
In the PaymentsOS Control Center, configure the following credentials:
  • apiLogin: The user name supplied by PayU Colombia
  • apiKey: The password name supplied by PayU Colombia
  • accountId: The identifier of the account in PayU Colombia
  • paymentCountry: COL
  • merchantId: The merchant ID in PayU Colombia
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 Colombia account, enable the validate unique. This will validate that each payment reference sent to the PayU Latam system is unique.Required
In your PayU Colombia account, enable the 'Process without a cvv2 security code' feature if you intend to use it.Optional
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.

Handling the Charge Request Response for Cash Transactions

If the charge request is successful, then the provider will return a charge response containing:

  • A status of pending.
  • The expiration date of the Payment Receipt.
  • A provider_data.document object with href links to the Payment Receipt in HTML format and possibly the Payment Receipt in PDF format.

Note that the provider_data.additional_information field may contain a barcode, for receipt tracking purposes.

Now direct your customer to one, or both of the transaction payment receipts, so that they can print the receipt. Your customer should then take the payment receipt to the relevant Payment Office and pay for their purchase, before the expiration date.

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

Permission to use the PSE Payment Method

PSE Certification

PSE certification is required, before being allowed to use the PSE payment method. To receive certification, you'll need to conform to the specifications setup by the ACH organization, which is responsible for the PSE payment method.

Creating a PSE Bank Transfer Capture Page

The PSE Bank Transfer Capture page is used by your customer, to capture their PSE Bank Transfer details. Create this page on your site according to the specifications described in the PayU PSE (Colombia) Certification Guide (Download as PDF or Download as HTML).

Redirecting your customer to Capture the PSE Bank Transfer

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 PSE Bank Transfer Capture page on your site), so that they can capture the bank transfer.

For detail of how to create the PSE Bank Transfer Capture page on your site, and how your customer should capture a PSE bank transfer, see the Permission to use the PSE Payment Method section above.

Once the PSE bank transfer has been captured, we'll redirect your customer's browser back to your site, using the merchant_site_url (that you provided in the post charge request). 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: payment_id, charge_id, and 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

Partial Refund Limitations

While partial refunds are supported, the following limitations apply:

  • You can send any amount for the partial refund as long as the value doesn’t exceed the initial or actual amount.

  • You can send as many as partial refund request as you require. The sum of the partial refund amounts cannot not exceed the total value of the transaction.

  • A partial refund request will always get a status of pending in the response. Partial refunds are processed manually by a PayU representative. The refund may take 2 to 6 calendar days to be processed. Once done, depending on the acquirer, the amount will appear in the extract in the next 1 to 30 days after the partial refund is processed.

  • If a partial refund is pending or is being processed, you cannot send a new request until the last one is processed.

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.

Test Procedures for Bank Transfers

Use the following test values in the post charge request:

  "bank_transfer_financial_institution_code": "1022",
  "bank_transfer_financial_institution_name": "BANCO UNION COLOMBIANO",
  "user_type": "N",
  "national_identify_number_type": "CC",

Follow a step by step procedure to test PSE bank transfers in the PayU Sandbox environment. For details see the PSE Test Guide (PDF).

results matching ""

    No results matching ""