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.0.0
The following features require an API version higher than the minimum:
- 3DS 2.0 External requires API version 1.3.0
Before starting your implementation, you should verify with your PayU Romania Account Manager, which of the payment methods with installments are enabled in your account.
The following table lists all supported payment methods.
|Payment Method||Payment Method Type||Notes|
|ALPHABANK INSTALLMENTS||Cards||Without installments|
|BCR Click 24||Bank Transfer|
|BCR INSTALLMENTS||Cards||Without installments|
|BRD INSTALLMENTS||Cards||Without installments|
|BT24 Internet Banking||Bank Transfer|
|CARD AVANTAJ||Cards||Without installments|
|GARANTI RO||Cards||Without installments|
|VISA Electron||Cards||With installments|
RON, USD, EUR, GBP, HUF, BGN, CZK, DKK, PLN, SEK, HRK, and UAH.
The following table provides an overview of all supported and non-supported features.
The following table lists all supported requests for card-based transactions. Use the bodybuilder to create a sample request body for each request type.
|Authorize||Partial and multiple are not supported||Asynchronous||Automatic capture is supported.|
|Capture||Partial is supported||Asynchronous||Support for partial Capture depends on the specific acquirer.|
|Refund||Partial is supported||Asynchronous|
|Authorize||Partial and multiple are not supported||Synchronous|
|Capture||Partial and multiple are not supported||Synchronous|
The following table lists the setup procedures that are specific to this provider.
|In the PaymentsOS Control Center, configure the following credentials: |
For testing in the sandbox environment, contact your PayU Romania account representative to request a dedicated testing account. Alternatively, use the following credentials to test in a shared environment:
|In your PayU Romania account, configure the currencies you want to use in transactions. Contact PayU Romania support for assistance.||Required|
|In your PayU Romania account, enable IPNs (Instant Payment Notifications). This will ensure that PaymentsOS is kept in sync with PayU systems. See Configuring IPN Settings below. Contact PayU Romania support for assistance.||Required|
|If you intend to use an external 3DS flow, make sure to verify the following: ||Optional|
|If you intend to use fast refunds, make sure your account has been configured to support card tokenization. Contact PayU Romania support for assistance.|
Note: With a fast refund, the refund amount is paid to the customer within 30 minutes after the refund has been processed. Fast refunds are only supported for payments done in RON, EUR or USD with MasterCard or Visa. Use the Bodybuilder to generate a sample Create Refund request that includes the field for requesting a fast refund (make sure check the 'Include optional fields in the output' checkbox).
The following sections list the integration procedures that are specific to this provider.
Considerations when Creating an Authorization
The authorization amount may be higher than the
payment.amount, due to commissions related to installments. The final
authorization.amount can be seen in the response to the authorization request.
Configuring IPN settings
Enabling IPNs is mandatory, to keep the PaymentsOS platform in sync with PayU systems.
Login to your PayU Romania account, and choose Account Management > Account Settings > IPN Settings.
First, set the following IPN URL fFor the PaymentsOS live environment: https://api.paymentsos.com/callbacks/payuromania/live/notifications
Next, select the following (required) fields:
IPN_TOTALGENERAL. We recommend selecting all the fields.
Now enable IPNs in your PayU Romania account by choosing Account Settings > Notifications > Type of notifications, and select
IPN (Instant Payment Notification) (by default, only
Authorized orders is enabled.)
As a last step, Activate all IPN types by choosing Account Settings > Notifications > Send notifications for, and select:
- Canceled and returned orders
- Complete orders
Redirecting your Customer for Redirection Flows (Bank Transfer Payment Methods and 3DS)
When you send a
post authorization request, a redirection flow may be required (for instance for 3D Secure authentication, or if the customer chooses to pay using a bank transfer payment method). If so, we will return an authorization resource containing an
authorization.redirection.url, and a status of 'pending'. Redirect your customer to this URL, so that they can authenticate themselves / complete the payment flow.
Once the redirection session is done, we'll redirect your customer's browser back to your site, using the
merchant_site_url (that you provided in the
post authorization 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:
status (of the authorization). Here's an example:
<merchant_site_url> ?payment_id=dd1fbe34-4636-4a61-8cb1-27ac8a175284 &authorization_id=aec1c306-e0f7-452b-8fb5-5b34489e9d10 &status=Pending
The status of your authorization request may still be 'pending' when we redirect your customer back to your site (while the provider is processing the request).
You can use the following test cards for testing:
|Test Card Number||Expiration Month||Expiration Year||CVV / CVC2||Cardholder Name||3DS Enrolled||Payment Status||Error received|
|4111111111111111||12||2020||123||Any name||YES||Success payment||-|
|4111111111111111||11||2020||123||Any name||No||Success payment||-|
|5105105105105100||11||2020||123||Any name||No||Failed payment||Not sufficient funds|
|5563693062030796||11||2020||123||Any name||No||Failed payment||Stolen card, pick up|
|4921301010459253||11||2020||123||Any name||No||Failed payment||Default error|
You can test installments payment methods using the following card details for different testing scenarios:
|Brand||Test Card Numbers||Expiration Month||Expiration Year||CVV / CVC2||Cardholder Name|
|Garanti Bonus Card||5555003167580804