PayU Romania
Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.
- API Version
- Payment Methods
- Currencies
- Features
- Requests
- Setup Procedures
- Integration Procedures
- Testing
API Version
Minimum required API version: 1.0.0
The following features require an API version higher than the minimum:
- 3DS 2.0 Internal requires API version 1.3.0
- 3DS 2.0 External requires API version 1.3.0
Payment Methods
Note
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 | With installments |
BCR Click 24 | Bank Transfer | |
BCR INSTALLMENTS | Cards | With installments |
BRD INSTALLMENTS | Cards | With installments |
BRDF | Cards | With installments |
BT24 Internet Banking | Bank Transfer | |
CARD AVANTAJ | Cards | With installments |
GARANTI RO | Cards | With installments |
MAESTRO | Cards | Without installments |
MASTERCARD | Cards | Without installments |
OPTIMO | Cards | With installments |
RAIFFEISEN | Cards | With installments |
STAR_BT | Cards | With installments |
VISA | Cards | Without installments |
VISA Electron | Cards | Without installments |
Currencies
RON, USD, EUR, GBP, HUF, BGN, CZK, DKK, PLN, SEK, HRK, and UAH.
Features
The following table provides an overview of all supported and non-supported features.
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 |
---|---|---|---|
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 | |
Void | Not Applicable | Asynchronous |
Request | Partial/Multiple | Mode |
---|---|---|
Authorize | Partial and multiple are not supported | Synchronous |
Capture | Partial and multiple are not supported | Synchronous |
Setup Procedures
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:
| Required |
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). | Optional |
Integration Procedures
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:SALEDATE
, REFNOEXT
, ORDERSTATUS
, IPN_PID[]
, IPN_PNAME[]
, IPN_DATE
, and 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: payment_id
, authorization_id
, and 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
Note
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).
Testing
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:
cPanel URL: https://sandbox.payu.ro/cpanel/
User: support@zooz.com
Password: Zooz@2018
Merchant ID: DEMOROSB
Secret Key: 1231234567890123
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 |
---|---|---|---|---|---|
Card Avantaj | 5186170004106668 5186170028360523 5186170008405330 |
03 | 2021 | 123 | Any Name |
BRD Finance | 5220620107681833 5220620150352787 5220620137283642 |
03 | 2021 | 123 | Any Name |
Star BT | 4555552420664386 4555551748017871 4555553122374365 |
03 | 2021 | 123 | Any Name |
Raiffeisen | 6011116461271023 6011113186588013 6011113776422151 |
03 | 2021 | 123 | Any Name |
Garanti Bonus Card | 5555003167580804 5555004528364631 5555004866445521 |
03 | 2021 | 123 | Any Name |
BCR | 4999990806306657 4999995741805002 4999992252873230 |
03 | 2021 | 123 | Any Name |
AlphaBank | 4670935882226267 4670934671405661 4670935815277585 |
03 | 2021 | 123 | Any Name |