├── .gitignore
├── LICENSE
├── VERSION
├── changelog.md
├── composer.json
├── docs
├── delayed_capture.md
├── immediate_payment.md
├── payment_with_3dsecure_parameters.md
├── refund_payments.md
└── reservation_payment.md
├── examples
├── example_capture_amount.php
├── example_complete_3ds_authenticated_payment.php
├── example_finish_reservation.php
├── example_get_payment_details.php
├── example_payee_transactions.php
├── example_recurring_payment_with_3dsecure.php
├── example_refund_payment.php
├── example_start_delayedcapture_payment.php
├── example_start_immediate_payment.php
├── example_start_payment_with_3dsecure_parameters.php
└── example_start_reservation_payment.php
├── library
├── BarionClient.php
├── Enumerations
│ ├── BarionEnvironment.php
│ ├── CardType.php
│ ├── Currency.php
│ ├── FundingSourceType.php
│ ├── PaymentStatus.php
│ ├── PaymentType.php
│ ├── QRCodeSize.php
│ ├── RecurrenceResult.php
│ ├── ThreeDSecure
│ │ ├── AccountChangeIndicator.php
│ │ ├── AccountCreationIndicator.php
│ │ ├── AvailabilityIndicator.php
│ │ ├── ChallengePreference.php
│ │ ├── DeliveryTimeframeType.php
│ │ ├── PasswordChangeIndicator.php
│ │ ├── PaymentMethodIndicator.php
│ │ ├── PurchaseType.php
│ │ ├── ReOrderIndicator.php
│ │ ├── RecurrenceType.php
│ │ ├── ShippingAddressIndicator.php
│ │ ├── ShippingAddressUsageIndicator.php
│ │ └── SuspiciousActivityIndicator.php
│ ├── TransactionStatus.php
│ ├── TransactionType.php
│ └── UILocale.php
├── Exceptions
│ └── BarionException.php
├── Helpers
│ ├── JSON.php
│ └── StringExtension.php
├── Interfaces
│ ├── IBarionModel.php
│ ├── IItemContainer.php
│ ├── IPayeeTransactionContainer.php
│ └── IPaymentTransactionContainer.php
├── Models
│ ├── BaseRequestModel.php
│ ├── BaseResponseModel.php
│ ├── Common
│ │ ├── BankCardModel.php
│ │ ├── FundingInformationModel.php
│ │ ├── ItemModel.php
│ │ ├── UserModel.php
│ │ └── UserNameModel.php
│ ├── Error
│ │ └── ApiErrorModel.php
│ ├── Payment
│ │ ├── CancelAuthorizationRequestModel.php
│ │ ├── CancelAuthorizationResponseModel.php
│ │ ├── CaptureRequestModel.php
│ │ ├── CaptureResponseModel.php
│ │ ├── Complete3DSPaymentRequestModel.php
│ │ ├── Complete3DSPaymentResponseModel.php
│ │ ├── FinishReservationRequestModel.php
│ │ ├── FinishReservationResponseModel.php
│ │ ├── GetPaymentStateRequestModel.php
│ │ ├── GetPaymentStateResponseModel.php
│ │ ├── PayeeTransactionModel.php
│ │ ├── PayeeTransactionToCaptureModel.php
│ │ ├── PayeeTransactionToFinishModel.php
│ │ ├── PaymentQRRequestModel.php
│ │ ├── PaymentStateRequestModel.php
│ │ ├── PaymentStateResponseModel.php
│ │ ├── PaymentTransactionModel.php
│ │ ├── PreparePaymentRequestModel.php
│ │ ├── PreparePaymentResponseModel.php
│ │ ├── TransactionDetailModel.php
│ │ ├── TransactionResponseModel.php
│ │ ├── TransactionToCaptureModel.php
│ │ ├── TransactionToFinishModel.php
│ │ └── TransactionToRefundModel.php
│ ├── Refund
│ │ ├── RefundRequestModel.php
│ │ ├── RefundResponseModel.php
│ │ └── RefundedTransactionModel.php
│ └── ThreeDSecure
│ │ ├── BillingAddressModel.php
│ │ ├── GiftCardPurchaseModel.php
│ │ ├── PayerAccountInformationModel.php
│ │ ├── PurchaseInformationModel.php
│ │ └── ShippingAddressModel.php
├── SSL
│ ├── cacert.pem
│ └── gd_bundle-g2.crt
└── autoload.php
└── readme.md
/.gitignore:
--------------------------------------------------------------------------------
1 | ## OS X
2 | .DS_Store
3 |
4 | /_ReSharper.Caches
5 | /.vs
6 |
7 | /vendor/
8 | composer.lock
9 |
--------------------------------------------------------------------------------
/VERSION:
--------------------------------------------------------------------------------
1 | 2.0.0
--------------------------------------------------------------------------------
/changelog.md:
--------------------------------------------------------------------------------
1 | # Changelog
2 |
3 | ### v2.0.0 2024-07-16
4 |
5 | - Minimum supported PHP version increased to 8.2+
6 | - Fully supported Composer-based autoloading
7 | - PSR-4 compliant file structure
8 | - Library is now properly namespaced under `Barion\`
9 | - Enumerations are using native enums in separate files
10 | - API calls now support header-based POSKey authentication
11 | - Allowed funding sources now include Apple Pay and Google Pay
12 | - PaymentState request is now implemented at API version 4
13 | - Added Spanish (es-ES) locale to the supported Barion Smart Gateway languages
14 | - Updated examples and docs
15 | - Added PHPDoc annotation
16 | - Client throws exception if PHP version is not sufficient or cURL extension is not available
17 | - Client throws exception if an incorrect API version is specified for a method
18 | - API version can now be set on-the-fly between calls
19 |
20 | ### [v1.4.11](https://github.com/barion/barion-web-php/releases/tag/v1.4.11) 2024-04-02
21 |
22 | - Updating bundled CA certificates
23 |
24 | ### [v1.4.10](https://github.com/barion/barion-web-php/releases/tag/v1.4.10) 2022-06-13
25 |
26 | - Fixed PaymentId parsing in API error models
27 |
28 | ### [v1.4.9](https://github.com/barion/barion-web-php/releases/tag/v1.4.9) 2022-06-09
29 |
30 | - Small fixes
31 |
32 | ### [v1.4.8](https://github.com/barion/barion-web-php/releases/tag/v1.4.8) 2022-06-09
33 |
34 | - Small fixes
35 |
36 | ### [v1.4.7](https://github.com/barion/barion-web-php/releases/tag/v1.4.7) 2022-05-25
37 |
38 | - Error response extended
39 |
40 | ### [v1.4.6](https://github.com/barion/barion-web-php/releases/tag/v1.4.6) 2021-04-28
41 |
42 | - CompletePayment response fix
43 |
44 | ### [v1.4.5](https://github.com/barion/barion-web-php/releases/tag/v1.4.5) 2021-04-15
45 |
46 | - Additional properties in the GetPaymentState response
47 |
48 | ### [v1.4.4](https://github.com/barion/barion-web-php/releases/tag/v1.4.4) 2021-01-17
49 |
50 | - RecurrenceType is fixed in GetPaymentState response
51 |
52 | ### [v1.4.3](https://github.com/barion/barion-web-php/releases/tag/v1.4.3) 2020-12-11
53 |
54 | - 3DS v2 token payment information added to the models
55 |
56 | ### [v1.4.2](https://github.com/barion/barion-web-php/releases/tag/v1.4.2) 2019-08-15
57 |
58 | - ADD: added RecurrenceType and ChallengePreference 3DS properties
59 |
60 | ### [v1.4.1](https://github.com/barion/barion-web-php/releases/tag/v1.4.1) 2019-08-14
61 |
62 | - FIX: fixed shipping address model parameters
63 | - ADD: detailed documentation for different payment scenarios
64 |
65 | ### [v1.4.0](https://github.com/barion/barion-web-php/releases/tag/v1.4.0) 2019-08-08
66 |
67 | - ADD: supporting payment properties related to 3D Secure authentication
68 | - ADD: support for Delayed Capture payment scenarios
69 |
70 | ### v1.3.2 2019-08-05
71 |
72 | - FIX: added shipping address model and fixed shipping address structure in examples
73 |
74 | ### [v1.3.1](https://github.com/barion/barion-web-php/releases/tag/v1.3.1) 2019-03-20
75 |
76 | - ADD: Greek locale support (el-GR)
77 |
78 | ### [v1.3](https://github.com/barion/barion-web-php/releases/tag/v1.3) 2019-03-12
79 |
80 | - ADD: CZK currency and czech locale
81 |
82 | ### [v1.2.9](https://github.com/barion/barion-web-php/releases/tag/v1.2.9) 2017-05-16
83 |
84 | - FIX: PaymenStateResponse extended to parse all the available fields
85 |
86 | ### [v1.2.8](https://github.com/barion/barion-web-php/releases/tag/v1.2.8) 2017-04-13
87 |
88 | - FIX: Refunded transactions parsed correctly
89 |
90 | ### [v1.2.7](https://github.com/barion/barion-web-php/releases/tag/v1.2.7) 2017-02-14
91 |
92 | - MERGE: Added FundingInformation and BankCard to PaymentStateResponse
93 | - MERGE: Added currency to PaymentStateResponseModel and TransactionDetailModel
94 | - Added "Expired", "PartiallySucceeded" and "InProgress" payment states to enumeration
95 |
96 | ### v1.2.5 2016-11-07
97 |
98 | - MERGE: Added currency handling to the start payment request model to handle EUR/USD currencies
99 |
100 | ### v1.2.4 2016-05-25
101 |
102 | - MERGE: Added parent constructor call to ResponseModels to get the Errors array initialized properly
103 |
104 | ### [v1.2.3](https://github.com/barion/barion-web-php/releases/tag/v1.2.3) 2016-01-14
105 |
106 | - FIX: Extra option for environments with SSL problems
107 | - FIX: Some issues with the models (finish reservation and QR models)
108 |
109 | ### v1.2.1 2016-01-11
110 |
111 | - FIX: Adding DIRECTORY_SEPARATOR to the path construction (thx to @zelding, based on: https://github.com/barion/barion-web-php/pull/1)
112 |
113 | ### v1.2.0 2016-01-11
114 |
115 | - SSL certificates included for the TEST environment
116 | - cURL errors are transferred to the client to help debugging
117 | - Removed end php tags
118 | - Added licencing headers
119 |
120 | ### v1.1.0 2015-11-27
121 |
122 | - Library class "Locale" renamed to "UILocale"
123 | - Minimized notices from uninitialized indices
124 |
125 | ### v1.0.1 2015-11-26
126 |
127 | - Fixed minor include path issues
128 |
129 | ### v1.0.0 2015-11-17
130 |
131 | - Initial release
132 |
133 | ---
134 |
135 | © 2017 Barion Payment Inc.
136 | All rights reserved.
137 |
--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "barion/barion-web-php",
3 | "description": "PHP libary for Barion Smart Gateway API integration",
4 | "type": "library",
5 | "require": {
6 | "php": ">=8.2",
7 | "ext-curl": "*"
8 | },
9 | "license": "Apache-2.0",
10 | "support": {
11 | "email": "devsupport@barion.com",
12 | "docs": "https://docs.barion.com",
13 | "chat": "https://discord.gg/rPkeS5fW"
14 | },
15 | "autoload": {
16 | "psr-4": {
17 | "Barion\\": "library/"
18 | }
19 | }
20 | }
21 |
--------------------------------------------------------------------------------
/docs/payment_with_3dsecure_parameters.md:
--------------------------------------------------------------------------------
1 | # Example - parameters related to 3D Secure authentication
2 |
3 | From September 2019 it will be mandatory for online payments to comply with 3D Secure authentication whenever the bank card used for payment is protected by 3D Secure.
4 | The Barion library has been extended with support to special parameters related to 3D Secure authentication.
5 |
6 | The purpose of these parameters is to help the Barion API and the webshop cooperate on making the payment process as smooth and frictionless as possible.
7 |
8 | ### Constructing the payment request
9 |
10 | The process is identical to any other simple payment scenario, only the parameter count changed.
11 |
12 | There is one or more **ItemModel** describing the product, as usual:
13 |
14 | ```php
15 | $item = new ItemModel();
16 | $item->Name = "TestItem";
17 | $item->Description = "A test item for payment";
18 | $item->Quantity = 1;
19 | $item->Unit = "pc";
20 | $item->UnitPrice = 75;
21 | $item->ItemTotal = 75;
22 | $item->SKU = "ITEM-01";
23 | ```
24 |
25 | These items are then added to a transaction:
26 |
27 | ```php
28 | $trans = new PaymentTransactionModel();
29 | $trans->POSTransactionId = "TRANS-01";
30 | $trans->Payee = $myEmailAddress;
31 | $trans->Total = 75;
32 | $trans->Comment = "Test Transaction";
33 | $trans->AddItem($item);
34 | ```
35 |
36 | And here come the additional parameters. First, the shipping and billing addresses:
37 |
38 | ```php
39 | $shippingAddress = new ShippingAddressModel();
40 | $shippingAddress->Country = "DE";
41 | $shippingAddress->Region = null;
42 | $shippingAddress->City = "Berlin";
43 | $shippingAddress->Zip = "10243";
44 | $shippingAddress->Street = "Karl-Marx-Allee 93A";
45 | $shippingAddress->Street2 = "1. ebene";
46 | $shippingAddress->Street3 = "";
47 | $shippingAddress->FullName = "Thomas Testing";
48 |
49 | $billingAddress = new BillingAddressModel();
50 | $billingAddress->Country = "DE";
51 | $billingAddress->Region = null;
52 | $billingAddress->City = "Berlin";
53 | $billingAddress->Zip = "10243";
54 | $billingAddress->Street = "Karl-Marx-Allee 93A";
55 | $billingAddress->Street2 = "1. ebene";
56 | $billingAddress->Street3 = "";
57 | ```
58 |
59 | **NOTE:** the older version of the library used the shipping address as one simple string. This method will NO LONGER WORK, the address structure must fully comply with the API documentation. Please review any request assembling in your integration where you are handling a shipping address.
60 |
61 | The webshop should supply as much information about the account of the customer as it can. This is done in the **PayerAccountInformationModel**.
62 |
63 | ```php
64 | $payerAccountInfo = new PayerAccountInformationModel();
65 | $payerAccountInfo->AccountId = "4444888888885559";
66 | $payerAccountInfo->AccountCreated = $now;
67 | $payerAccountInfo->AccountCreationIndicator = AccountCreationIndicator::CreatedDuringThisTransaction;
68 | $payerAccountInfo->AccountLastChanged = $now;
69 | $payerAccountInfo->AccountChangeIndicator = AccountChangeIndicator::ChangedDuringThisTransaction;
70 | $payerAccountInfo->PasswordLastChanged = $now;
71 | $payerAccountInfo->PasswordChangeIndicator = PasswordChangeIndicator::NoChange;
72 | $payerAccountInfo->PurchasesInTheLastSixMonths = 6;
73 | $payerAccountInfo->ShippingAddressAdded = $now;
74 | $payerAccountInfo->ShippingAddressUsageIndicator = ShippingAddressUsageIndicator::ThisTransaction;
75 | $payerAccountInfo->PaymentMethodAdded = $now;
76 | $payerAccountInfo->PaymentMethodIndicator = PaymentMethodIndicator::ThisTransaction;
77 | $payerAccountInfo->ProvisionAttempts = 1;
78 | $payerAccountInfo->TransactionalActivityPerDay = 1;
79 | $payerAccountInfo->TransactionalActivityPerYear = 100;
80 | $payerAccountInfo->SuspiciousActivityIndicator = SuspiciousActivityIndicator::NoSuspiciousActivityObserved;
81 | ```
82 |
83 | Similarly, all known information about the purchase itself shall be supplied in the **PurchaseInformationModel**:
84 |
85 | ```php
86 | $purchaseInfo = new PurchaseInformationModel();
87 | $purchaseInfo->DeliveryTimeframe = DeliveryTimeFrameType::OvernightShipping;
88 | $purchaseInfo->DeliveryEmailAddress = "user@example.com";
89 | $purchaseInfo->PreOrderDate = "2019-08-01";
90 | $purchaseInfo->AvailabilityIndicator = AvailabilityIndicator::MerchandiseAvailable;
91 | $purchaseInfo->ReOrderIndicator = ReOrderIndicator::FirstTimeOrdered;
92 | $purchaseInfo->RecurringExpiry = "2099-12-31 23:59:59";
93 | $purchaseInfo->RecurringFrequency = "0";
94 | $purchaseInfo->ShippingAddressIndicator = ShippingAddressIndicator::ShipToCardholdersBillingAddress;
95 | $purchaseInfo->GiftCardPurchase = null;
96 | $purchaseInfo->PurchaseType = PurchaseType::GoodsAndServicePurchase;
97 | ```
98 |
99 | Lastly, the final **PreparePaymentRequestModel** can be constructed using the transactions and the extra parameters above, among with known phone numbers and credit card holder name of the customer.
100 |
101 | ```php
102 | $psr = new PreparePaymentRequestModel();
103 | $psr->GuestCheckout = true;
104 | $psr->PaymentType = PaymentType::Immediate;
105 | $psr->FundingSources = array(FundingSourceType::All);
106 | $psr->PaymentRequestId = "TESTPAY-01";
107 | $psr->PayerHint = "user@example.com";
108 | $psr->Locale = UILocale::EN;
109 | $psr->Currency = Currency::EUR;
110 | $psr->OrderNumber = "ORDER-0001";
111 | $psr->AddTransaction($trans);
112 |
113 | $psr->ShippingAddress = $shippingAddress;
114 | $psr->BillingAddress = $billingAddress;
115 | $psr->CardHolderNameHint = "John Doe";
116 | $psr->PayerPhoneNumber = "36301122334";
117 | $psr->PayerWorkPhoneNumber = "36301122334";
118 | $psr->PayerHomePhoneNumber = "36301122334";
119 | $psr->PayerAccountInformation = $payerAccountInfo;
120 | $psr->PurchaseInformation = $purchaseInfo;
121 | ```
122 |
123 | The complete payment request object looks like this:
124 |
125 | ```
126 | PreparePaymentRequestModel Object
127 | (
128 | [PaymentType] => Immediate
129 | [ReservationPeriod] =>
130 | [DelayedCapturePeriod] =>
131 | [PaymentWindow] => 00:30:00
132 | [GuestCheckout] => 1
133 | [FundingSources] => Array
134 | (
135 | [0] => All
136 | )
137 |
138 | [PaymentRequestId] => TESTPAY-01
139 | [PayerHint] => user@example.com
140 | [Transactions] => Array
141 | (
142 | [0] => PaymentTransactionModel Object
143 | (
144 | [POSTransactionId] => TRANS-01
145 | [Payee] => barionaccount@demo-merchant.shop
146 | [Total] => 75
147 | [Comment] => Test Transaction
148 | [Items] => Array
149 | (
150 | [0] => ItemModel Object
151 | (
152 | [Name] => TestItem
153 | [Description] => A test item for payment
154 | [Quantity] => 1
155 | [Unit] => pc
156 | [UnitPrice] => 75
157 | [ItemTotal] => 75
158 | [SKU] => ITEM-01
159 | )
160 |
161 | )
162 |
163 | [PayeeTransactions] => Array
164 | (
165 | )
166 |
167 | )
168 |
169 | )
170 |
171 | [Locale] => en-US
172 | [OrderNumber] => ORDER-0001
173 | [ShippingAddress] => ShippingAddressModel Object
174 | (
175 | [Country] => DE
176 | [Region] =>
177 | [City] => Berlin
178 | [Zip] => 10243
179 | [Street] => Karl-Marx-Allee 93A
180 | [Street2] => 1. ebene
181 | [Street3] =>
182 | [FullName] => Thomas Testing
183 | )
184 |
185 | [BillingAddress] => BillingAddressModel Object
186 | (
187 | [Country] => DE
188 | [Region] =>
189 | [City] => Berlin
190 | [Zip] => 10243
191 | [Street] => Karl-Marx-Allee 93A
192 | [Street2] => 1. ebene
193 | [Street3] =>
194 | )
195 |
196 | [InitiateRecurrence] =>
197 | [RecurrenceId] =>
198 | [RedirectUrl] =>
199 | [CallbackUrl] =>
200 | [Currency] => EUR
201 | [CardHolderNameHint] => John Doe
202 | [PayerPhoneNumber] => 36301122334
203 | [PayerWorkPhoneNumber] => 36301122334
204 | [PayerHomePhoneNumber] => 36301122334
205 | [PayerAccountInformation] => PayerAccountInformationModel Object
206 | (
207 | [AccountId] => 4690011905085639
208 | [AccountCreated] =>
209 | [AccountCreationIndicator] => CreatedDuringThisTransaction
210 | [AccountLastChanged] =>
211 | [AccountChangeIndicator] => ChangedDuringThisTransaction
212 | [PasswordLastChanged] =>
213 | [PasswordChangeIndicator] => NoChange
214 | [PurchasesInTheLastSixMonths] => 6
215 | [ShippingAddressAdded] =>
216 | [ShippingAddressUsageIndicator] => ThisTransaction
217 | [PaymentMethodAdded] =>
218 | [PaymentMethodIndicator] => ThisTransaction
219 | [ProvisionAttempts] => 1
220 | [TransactionalActivityPerDay] => 1
221 | [TransactionalActivityPerYear] => 100
222 | [SuspiciousActivityIndicator] => NoSuspiciousActivityObserved
223 | )
224 |
225 | [PurchaseInformation] => PurchaseInformationModel Object
226 | (
227 | [DeliveryTimeframe] => OvernightShipping
228 | [DeliveryEmailAddress] =>
229 | [PreOrderDate] =>
230 | [AvailabilityIndicator] => MerchandiseAvailable
231 | [ReOrderIndicator] => FirstTimeOrdered
232 | [RecurringExpiry] => 2099-12-31 23:59:59
233 | [RecurringFrequency] => 0
234 | [ShippingAddressIndicator] => ShipToCardholdersBillingAddress
235 | [GiftCardPurchase] =>
236 | [PurchaseType] => GoodsAndServicePurchase
237 | )
238 |
239 | [POSKey] =>
240 | )
241 | ```
242 |
243 | Nothing left than to call the API with the payment request:
244 |
245 | ```php
246 | $myPayment = $BC->PreparePayment($psr);
247 | ```
248 |
249 | From here the process is identical to any other payment scenario. The additional 3D Secure related data is used by the Barion server in payment card related communication. Detailed information about the 3D secure authentication result is not disclosed to the webshop.
250 |
251 | ## Detailed documentation
252 |
253 | We strongly suggest that you read this article about parameters related to 3D Secure authentication in the official Barion API documentation:
254 | https://docs.barion.com/Payment-Start-v2
255 |
--------------------------------------------------------------------------------
/examples/example_capture_amount.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
39 | $item->Description = "A test item for delayed capture payment"; // no more than 500 characters
40 | $item->Quantity = 1;
41 | $item->Unit = "piece"; // no more than 50 characters
42 | $item->UnitPrice = 1000;
43 | $item->ItemTotal = 1000;
44 | $item->SKU = "ITEM-01"; // no more than 100 characters
45 |
46 | // create the transaction model
47 | $trans = new TransactionToCaptureModel();
48 | $trans->TransactionId = "33333333-3333-3333-3333-333333333333"; // <-- Replace this with the original transaction ID!
49 | $trans->Total = 1000;
50 | $trans->Comment = "Transaction completed"; // no more than 640 characters
51 | $trans->AddItem($item);
52 |
53 | // create the request object
54 | $crm = new CaptureRequestModel($paymentId);
55 | $crm->AddTransaction($trans); // add the transaction to the request
56 |
57 | // send the request
58 | $captureResult = $BC->Capture($crm);
59 |
60 | if ($captureResult->RequestSuccessful) {
61 | // TODO: process the information contained in $finishReservationResult
62 | }
--------------------------------------------------------------------------------
/examples/example_complete_3ds_authenticated_payment.php:
--------------------------------------------------------------------------------
1 | Complete3DSPayment($completeRequest);
37 |
38 | if ($completeResult->RequestSuccessful) {
39 | // TODO: process the information contained in $completeResult
40 | }
--------------------------------------------------------------------------------
/examples/example_finish_reservation.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
34 | $item1->Description = "A test item for payment"; // no more than 500 characters
35 | $item1->Quantity = 1;
36 | $item1->Unit = "piece"; // no more than 50 characters
37 | $item1->UnitPrice = 1000;
38 | $item1->ItemTotal = 1000;
39 | $item1->SKU = "ITEM-01"; // no more than 100 characters
40 |
41 | $item2 = new ItemModel();
42 | $item2->Name = "AnotherTestItem"; // no more than 250 characters
43 | $item2->Description = "Another test item for payment"; // no more than 500 characters
44 | $item2->Quantity = 2;
45 | $item2->Unit = "piece"; // no more than 50 characters
46 | $item2->UnitPrice = 250;
47 | $item2->ItemTotal = 250;
48 | $item2->SKU = "ITEM-02"; // no more than 100 characters
49 |
50 | // create the transaction model
51 | $trans = new TransactionToFinishModel();
52 | $trans->TransactionId = "33333333-3333-3333-3333-333333333333"; // <-- Replace this with the original transaction ID!
53 | $trans->Total = 1500;
54 | $trans->Comment = "Reservation complete"; // no more than 640 characters
55 | $trans->AddItem($item1); // add the items to the transaction
56 | $trans->AddItem($item2);
57 |
58 | // create the request object
59 | $frrm = new FinishReservationRequestModel($paymentId);
60 | $frrm->AddTransaction($trans); // add the transaction to the request
61 |
62 | // send the request
63 | $finishReservationResult = $BC->FinishReservation($frrm);
64 |
65 | if ($finishReservationResult->RequestSuccessful) {
66 | // TODO: process the information contained in $finishReservationResult
67 | }
--------------------------------------------------------------------------------
/examples/example_get_payment_details.php:
--------------------------------------------------------------------------------
1 | PaymentState($paymentId);
31 |
32 | // TODO: process the information contained in $paymentDetails
--------------------------------------------------------------------------------
/examples/example_payee_transactions.php:
--------------------------------------------------------------------------------
1 | Name = "ExpensiveTestItem"; // no more than 250 characters
47 | $item->Description = "An expensive test item for payment"; // no more than 500 characters
48 | $item->Quantity = 1;
49 | $item->Unit = "piece"; // no more than 50 characters
50 | $item->UnitPrice = 50000;
51 | $item->ItemTotal = 50000;
52 | $item->SKU = "ITEM-03"; // no more than 100 characters
53 |
54 | // create the payee transactions
55 | $ptrans1 = new PayeeTransactionModel();
56 | $ptrans1->POSTransactionId = "PTRANS-01"; // no more than 100 characters
57 | $ptrans1->Payee = "user1@example.com"; // no more than 256 characters
58 | $ptrans1->Total = 1000;
59 | $ptrans1->Comment = "Royalties"; // no more than 640 characters
60 |
61 | $ptrans2 = new PayeeTransactionModel();
62 | $ptrans2->POSTransactionId = "PTRANS-02"; // no more than 100 characters
63 | $ptrans2->Payee = "user2@example.com"; // no more than 256 characters
64 | $ptrans2->Total = 3000;
65 | $ptrans2->Comment = "Royalties"; // no more than 640 characters
66 |
67 | // create the transaction
68 | $trans = new PaymentTransactionModel();
69 | $trans->POSTransactionId = "TRANS-03";
70 | $trans->Payee = $myEmailAddress; // no more than 256 characters
71 | $trans->Total = 50000;
72 | $trans->Comment = "Test Transaction"; // no more than 640 characters
73 | $trans->AddItem($item); // add the item to the transaction
74 | $trans->AddPayeeTransaction($ptrans1); // add the payee transactions to the transaction
75 | $trans->AddPayeeTransaction($ptrans2);
76 |
77 | // create the shipping address
78 | $shippingAddress = new ShippingAddressModel();
79 | $shippingAddress->Country = "HU";
80 | $shippingAddress->Region = null;
81 | $shippingAddress->City = "Budapest";
82 | $shippingAddress->Zip = "1111";
83 | $shippingAddress->Street = "Teszt utca 1.";
84 | $shippingAddress->Street2 = "1. emelet 1. ajto";
85 | $shippingAddress->Street3 = "";
86 | $shippingAddress->FullName = "Teszt Tibor";
87 |
88 | // create the request model
89 | $psr = new PreparePaymentRequestModel();
90 | $psr->GuestCheckout = true; // we allow guest checkout
91 | $psr->PaymentType = PaymentType::Immediate; // we want an immediate payment
92 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
93 | $psr->PaymentRequestId = "TESTPAY-03"; // no more than 100 characters
94 | $psr->PayerHint = "user@example.com"; // no more than 256 characters
95 | $psr->Locale = UILocale::EN; // the UI language will be English
96 | $psr->OrderNumber = "ORDER-0001"; // no more than 100 characters
97 | $psr->ShippingAddress = $shippingAddress;
98 | $psr->Currency = Currency::HUF;
99 | $psr->AddTransaction($trans); // add the transaction to the payment
100 |
101 | // send the request
102 | $myPayment = $BC->PreparePayment($psr);
103 |
104 | if ($myPayment->RequestSuccessful === true) {
105 | // redirect the user to the Barion Smart Gateway
106 | header("Location: " . $BC::BARION_WEB_URL_TEST . "?id=" . $myPayment->PaymentId);
107 | }
--------------------------------------------------------------------------------
/examples/example_recurring_payment_with_3dsecure.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
64 | $item->Description = "A test item for payment"; // no more than 500 characters
65 | $item->Quantity = 1;
66 | $item->Unit = "pc"; // no more than 50 characters
67 | $item->UnitPrice = 19.95;
68 | $item->ItemTotal = 19.95;
69 | $item->SKU = "ITEM-01"; // no more than 100 characters
70 |
71 | // create the transaction
72 | $trans = new PaymentTransactionModel();
73 | $trans->POSTransactionId = "TRANS-01";
74 | $trans->Payee = $myEmailAddress; // no more than 256 characters
75 | $trans->Total = 19.95;
76 | $trans->Comment = "Test Transaction"; // no more than 640 characters
77 | $trans->AddItem($item); // add the item to the transaction
78 |
79 | // create the addresses
80 | $shippingAddress = new ShippingAddressModel();
81 | $shippingAddress->Country = "DE";
82 | $shippingAddress->Region = null;
83 | $shippingAddress->City = "Berlin";
84 | $shippingAddress->Zip = "10243";
85 | $shippingAddress->Street = "Karl-Marx-Allee 93A";
86 | $shippingAddress->Street2 = "1. ebene";
87 | $shippingAddress->Street3 = "";
88 | $shippingAddress->FullName = "Thomas Testing";
89 |
90 | $billingAddress = new BillingAddressModel();
91 | $billingAddress->Country = "DE";
92 | $billingAddress->Region = null;
93 | $billingAddress->City = "Berlin";
94 | $billingAddress->Zip = "10243";
95 | $billingAddress->Street = "Karl-Marx-Allee 93A";
96 | $billingAddress->Street2 = "1. ebene";
97 | $billingAddress->Street3 = "";
98 |
99 | // 3DS information about the payer
100 | $payerAccountInfo = new PayerAccountInformationModel();
101 | $payerAccountInfo->AccountId = "4690011905085639";
102 | $payerAccountInfo->AccountCreated = $now;
103 | $payerAccountInfo->AccountCreationIndicator = AccountCreationIndicator::CreatedDuringThisTransaction;
104 | $payerAccountInfo->AccountLastChanged = $now;
105 | $payerAccountInfo->AccountChangeIndicator = AccountChangeIndicator::ChangedDuringThisTransaction;
106 | $payerAccountInfo->PasswordLastChanged = $now;
107 | $payerAccountInfo->PasswordChangeIndicator = PasswordChangeIndicator::NoChange;
108 | $payerAccountInfo->PurchasesInTheLastSixMonths = 6;
109 | $payerAccountInfo->ShippingAddressAdded = $now;
110 | $payerAccountInfo->ShippingAddressUsageIndicator = ShippingAddressUsageIndicator::ThisTransaction;
111 | $payerAccountInfo->PaymentMethodAdded = $now;
112 | $payerAccountInfo->PaymentMethodIndicator = PaymentMethodIndicator::ThisTransaction;
113 | $payerAccountInfo->ProvisionAttempts = 1;
114 | $payerAccountInfo->TransactionalActivityPerDay = 1;
115 | $payerAccountInfo->TransactionalActivityPerYear = 100;
116 | $payerAccountInfo->SuspiciousActivityIndicator = SuspiciousActivityIndicator::NoSuspiciousActivityObserved;
117 |
118 | // 3DS information about the purchase
119 | $purchaseInfo = new PurchaseInformationModel();
120 | $purchaseInfo->DeliveryTimeframe = DeliveryTimeFrameType::OvernightShipping;
121 | $purchaseInfo->DeliveryEmailAddress = $payerEmail;
122 | $purchaseInfo->PreOrderDate = $now;
123 | $purchaseInfo->AvailabilityIndicator = AvailabilityIndicator::MerchandiseAvailable;
124 | $purchaseInfo->ReOrderIndicator = ReOrderIndicator::FirstTimeOrdered;
125 | $purchaseInfo->RecurringExpiry = "2099-12-31 23:59:59";
126 | $purchaseInfo->RecurringFrequency = "0";
127 | $purchaseInfo->ShippingAddressIndicator = ShippingAddressIndicator::ShipToCardholdersBillingAddress;
128 | $purchaseInfo->GiftCardPurchase = null;
129 | $purchaseInfo->PurchaseType = PurchaseType::GoodsAndServicePurchase;
130 |
131 | // create the request model
132 | $psr = new PreparePaymentRequestModel();
133 | $psr->GuestCheckout = true; // we allow guest checkout
134 | $psr->PaymentType = PaymentType::Immediate; // we want an immediate payment
135 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
136 | $psr->PaymentRequestId = "TESTPAY-01"; // no more than 100 characters
137 | $psr->PayerHint = $payerEmail; // no more than 256 characters
138 | $psr->Locale = UILocale::EN; // the UI language will be English
139 | $psr->Currency = Currency::EUR;
140 | $psr->OrderNumber = "ORDER-0001"; // no more than 100 characters
141 | $psr->AddTransaction($trans); // add the transaction to the payment
142 |
143 | // adding the 3d secure compliant parameters to the request
144 | $psr->ShippingAddress = $shippingAddress;
145 | $psr->BillingAddress = $billingAddress;
146 | $psr->CardHolderNameHint = "John Doe";
147 | $psr->PayerPhoneNumber = "36301122334";
148 | $psr->PayerWorkPhoneNumber = "36301122334";
149 | $psr->PayerHomePhoneNumber = "36301122334";
150 | $psr->PayerAccountInformation = $payerAccountInfo;
151 | $psr->PurchaseInformation = $purchaseInfo;
152 | $psr->ChallengePreference = ChallengePreference::NoPreference;
153 |
154 | // setting the properties related to token/recurring payment
155 | $psr->InitiateRecurrence = false; // InitiateRecurrence is false, because the webshop already has a token initialized
156 | $psr->RecurrenceId = "XXXXXXXX"; // replace this with the previously initialized token for this recurrence
157 | $psr->RecurrenceType = "RecurringPayment"; // RecurrenceType indicates that this is a recurring payment charge (for merchant-initiated, or simple token payments, use 'MerchantInitiatedPayment' instead)
158 | $psr->TraceId = "XXXXXXXX"; // replace this with the corresponding TraceId received when initializing the token payment!
159 |
160 | // send the request
161 | $paymentResponse = $BC->PreparePayment($psr);
162 |
163 | if ($paymentResponse->RequestSuccessful === true) {
164 | // NOTE: since this is a recurring payment execution, no redirect is taking place - the charge happens immediately
165 | // TODO: process the response found in $paymentResponse
166 | }
--------------------------------------------------------------------------------
/examples/example_refund_payment.php:
--------------------------------------------------------------------------------
1 | AddTransaction($trans);
49 |
50 | $refundResult = $BC->RefundPayment($rr);
51 |
52 | if ($refundResult->RequestSuccessful) {
53 | // TODO: process the information contained in $refundResult
54 | }
--------------------------------------------------------------------------------
/examples/example_start_delayedcapture_payment.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
46 | $item->Description = "A test item for delayed capture payment"; // no more than 500 characters
47 | $item->Quantity = 1;
48 | $item->Unit = "piece"; // no more than 50 characters
49 | $item->UnitPrice = 1000;
50 | $item->ItemTotal = 1000;
51 | $item->SKU = "ITEM-01"; // no more than 100 characters
52 |
53 | // create the transaction
54 | $trans = new PaymentTransactionModel();
55 | $trans->POSTransactionId = "TRANS-01";
56 | $trans->Payee = $myEmailAddress; // no more than 256 characters
57 | $trans->Total = 1000;
58 | $trans->Comment = "Test Transaction"; // no more than 640 characters
59 | $trans->AddItem($item); // add the item to the transaction
60 |
61 | // create the shipping address
62 | $shippingAddress = new ShippingAddressModel();
63 | $shippingAddress->Country = "HU";
64 | $shippingAddress->Region = null;
65 | $shippingAddress->City = "Budapest";
66 | $shippingAddress->Zip = "1111";
67 | $shippingAddress->Street = "Teszt utca 1.";
68 | $shippingAddress->Street2 = "1. emelet 1. ajto";
69 | $shippingAddress->Street3 = "";
70 | $shippingAddress->FullName = "Teszt Tibor";
71 |
72 | // create the request model
73 | $psr = new PreparePaymentRequestModel();
74 | $psr->GuestCheckout = true; // we allow guest checkout
75 | $psr->PaymentType = PaymentType::DelayedCapture; // we want a delayed capture payment
76 | $psr->DelayedCapturePeriod = "3:00:00:00"; // capture is delayed for 3 days
77 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
78 | $psr->PaymentRequestId = "TESTPAY-01"; // no more than 100 characters
79 | $psr->PayerHint = "user@example.com"; // no more than 256 characters
80 | $psr->Locale = UILocale::EN; // the UI language will be English
81 | $psr->Currency = Currency::HUF;
82 | $psr->OrderNumber = "ORDER-0001"; // no more than 100 characters
83 | $psr->ShippingAddress = $shippingAddress;
84 | $psr->AddTransaction($trans); // add the transaction to the payment
85 |
86 | // send the request
87 | $myPayment = $BC->PreparePayment($psr);
88 |
89 | if ($myPayment->RequestSuccessful === true) {
90 | // redirect the user to the Barion Smart Gateway
91 | header("Location: " . $BC::BARION_WEB_URL_TEST . "?id=" . $myPayment->PaymentId);
92 | }
--------------------------------------------------------------------------------
/examples/example_start_immediate_payment.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
46 | $item->Description = "A test item for payment"; // no more than 500 characters
47 | $item->Quantity = 1;
48 | $item->Unit = "piece"; // no more than 50 characters
49 | $item->UnitPrice = 1000;
50 | $item->ItemTotal = 1000;
51 | $item->SKU = "ITEM-01"; // no more than 100 characters
52 |
53 | // create the transaction
54 | $trans = new PaymentTransactionModel();
55 | $trans->POSTransactionId = "TRANS-01";
56 | $trans->Payee = $myEmailAddress; // no more than 256 characters
57 | $trans->Total = 1000;
58 | $trans->Comment = "Test Transaction"; // no more than 640 characters
59 | $trans->AddItem($item); // add the item to the transaction
60 |
61 | // create the shipping address
62 | $shippingAddress = new ShippingAddressModel();
63 | $shippingAddress->Country = "HU";
64 | $shippingAddress->Region = null;
65 | $shippingAddress->City = "Budapest";
66 | $shippingAddress->Zip = "1111";
67 | $shippingAddress->Street = "Teszt utca 1.";
68 | $shippingAddress->Street2 = "1. emelet 1. ajto";
69 | $shippingAddress->Street3 = "";
70 | $shippingAddress->FullName = "Teszt Tibor";
71 |
72 | // create the request model
73 | $psr = new PreparePaymentRequestModel();
74 | $psr->GuestCheckout = true; // we allow guest checkout
75 | $psr->PaymentType = PaymentType::Immediate; // we want an immediate payment
76 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
77 | $psr->PaymentRequestId = "TESTPAY-01"; // no more than 100 characters
78 | $psr->PayerHint = "user@example.com"; // no more than 256 characters
79 | $psr->Locale = UILocale::EN; // the UI language will be English
80 | $psr->Currency = Currency::HUF;
81 | $psr->OrderNumber = "ORDER-0001"; // no more than 100 characters
82 | $psr->ShippingAddress = $shippingAddress;
83 | $psr->AddTransaction($trans); // add the transaction to the payment
84 |
85 | // send the request
86 | $myPayment = $BC->PreparePayment($psr);
87 |
88 | if ($myPayment->RequestSuccessful === true) {
89 | // redirect the user to the Barion Smart Gateway
90 | header("Location: " . $BC::BARION_WEB_URL_TEST . "?id=" . $myPayment->PaymentId);
91 | }
--------------------------------------------------------------------------------
/examples/example_start_payment_with_3dsecure_parameters.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
69 | $item->Description = "A test item for payment"; // no more than 500 characters
70 | $item->Quantity = 1;
71 | $item->Unit = "pc"; // no more than 50 characters
72 | $item->UnitPrice = 75;
73 | $item->ItemTotal = 75;
74 | $item->SKU = "ITEM-01"; // no more than 100 characters
75 |
76 | // create the transaction
77 | $trans = new PaymentTransactionModel();
78 | $trans->POSTransactionId = "TRANS-01";
79 | $trans->Payee = $myEmailAddress; // no more than 256 characters
80 | $trans->Total = 75;
81 | $trans->Comment = "Test Transaction"; // no more than 640 characters
82 | $trans->AddItem($item); // add the item to the transaction
83 |
84 | // create the addresses
85 | $shippingAddress = new ShippingAddressModel();
86 | $shippingAddress->Country = "DE";
87 | $shippingAddress->Region = null;
88 | $shippingAddress->City = "Berlin";
89 | $shippingAddress->Zip = "10243";
90 | $shippingAddress->Street = "Karl-Marx-Allee 93A";
91 | $shippingAddress->Street2 = "1. ebene";
92 | $shippingAddress->Street3 = "";
93 | $shippingAddress->FullName = "Thomas Testing";
94 |
95 | $billingAddress = new BillingAddressModel();
96 | $billingAddress->Country = "DE";
97 | $billingAddress->Region = null;
98 | $billingAddress->City = "Berlin";
99 | $billingAddress->Zip = "10243";
100 | $billingAddress->Street = "Karl-Marx-Allee 93A";
101 | $billingAddress->Street2 = "1. ebene";
102 | $billingAddress->Street3 = "";
103 |
104 | // 3DS information about the payer
105 | $payerAccountInfo = new PayerAccountInformationModel();
106 | $payerAccountInfo->AccountId = "4690011905085639";
107 | $payerAccountInfo->AccountCreated = $now;
108 | $payerAccountInfo->AccountCreationIndicator = AccountCreationIndicator::CreatedDuringThisTransaction;
109 | $payerAccountInfo->AccountLastChanged = $now;
110 | $payerAccountInfo->AccountChangeIndicator = AccountChangeIndicator::ChangedDuringThisTransaction;
111 | $payerAccountInfo->PasswordLastChanged = $now;
112 | $payerAccountInfo->PasswordChangeIndicator = PasswordChangeIndicator::NoChange;
113 | $payerAccountInfo->PurchasesInTheLastSixMonths = 6;
114 | $payerAccountInfo->ShippingAddressAdded = $now;
115 | $payerAccountInfo->ShippingAddressUsageIndicator = ShippingAddressUsageIndicator::ThisTransaction;
116 | $payerAccountInfo->PaymentMethodAdded = $now;
117 | $payerAccountInfo->PaymentMethodIndicator = PaymentMethodIndicator::ThisTransaction;
118 | $payerAccountInfo->ProvisionAttempts = 1;
119 | $payerAccountInfo->TransactionalActivityPerDay = 1;
120 | $payerAccountInfo->TransactionalActivityPerYear = 100;
121 | $payerAccountInfo->SuspiciousActivityIndicator = SuspiciousActivityIndicator::NoSuspiciousActivityObserved;
122 |
123 | // 3DS information about the purchase
124 | $purchaseInfo = new PurchaseInformationModel();
125 | $purchaseInfo->DeliveryTimeframe = DeliveryTimeFrameType::OvernightShipping;
126 | $purchaseInfo->DeliveryEmailAddress = $payerEmail;
127 | $purchaseInfo->PreOrderDate = $now;
128 | $purchaseInfo->AvailabilityIndicator = AvailabilityIndicator::MerchandiseAvailable;
129 | $purchaseInfo->ReOrderIndicator = ReOrderIndicator::FirstTimeOrdered;
130 | $purchaseInfo->RecurringExpiry = "2099-12-31 23:59:59";
131 | $purchaseInfo->RecurringFrequency = "0";
132 | $purchaseInfo->ShippingAddressIndicator = ShippingAddressIndicator::ShipToCardholdersBillingAddress;
133 | $purchaseInfo->GiftCardPurchase = null;
134 | $purchaseInfo->PurchaseType = PurchaseType::GoodsAndServicePurchase;
135 | $purchaseInfo->PurchaseDate = "2021-05-01 10:00:00";
136 |
137 | // create the request model
138 | $psr = new PreparePaymentRequestModel();
139 | $psr->GuestCheckout = true; // we allow guest checkout
140 | $psr->PaymentType = PaymentType::Immediate; // we want an immediate payment
141 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
142 | $psr->PaymentRequestId = "TESTPAY-01"; // no more than 100 characters
143 | $psr->PayerHint = $payerEmail; // no more than 256 characters
144 | $psr->Locale = UILocale::EN; // the UI language will be English
145 | $psr->Currency = Currency::EUR;
146 | $psr->OrderNumber = "ORDER-0001"; // no more than 100 characters
147 | $psr->AddTransaction($trans); // add the transaction to the payment
148 |
149 | // adding the 3d secure compliant parameters to the request
150 | $psr->ShippingAddress = $shippingAddress;
151 | $psr->BillingAddress = $billingAddress;
152 | $psr->CardHolderNameHint = "John Doe";
153 | $psr->PayerPhoneNumber = "36301122334";
154 | $psr->PayerWorkPhoneNumber = "36301122334";
155 | $psr->PayerHomePhoneNumber = "36301122334";
156 | $psr->PayerAccountInformation = $payerAccountInfo;
157 | $psr->PurchaseInformation = $purchaseInfo;
158 | $psr->ChallengePreference = ChallengePreference::NoPreference;
159 |
160 | // send the request
161 | $myPayment = $BC->PreparePayment($psr);
162 |
163 | if ($myPayment->RequestSuccessful === true) {
164 | // redirect the user to the Barion Smart Gateway
165 | header("Location: " . $BC::BARION_WEB_URL_TEST . "?id=" . $myPayment->PaymentId);
166 | }
--------------------------------------------------------------------------------
/examples/example_start_reservation_payment.php:
--------------------------------------------------------------------------------
1 | Name = "TestItem"; // no more than 250 characters
46 | $item1->Description = "A test item for payment"; // no more than 500 characters
47 | $item1->Quantity = 1;
48 | $item1->Unit = "piece"; // no more than 50 characters
49 | $item1->UnitPrice = 1000;
50 | $item1->ItemTotal = 1000;
51 | $item1->SKU = "ITEM-01"; // no more than 100 characters
52 |
53 | $item2 = new ItemModel();
54 | $item2->Name = "AnotherTestItem"; // no more than 250 characters
55 | $item2->Description = "Another test item for payment"; // no more than 500 characters
56 | $item2->Quantity = 2;
57 | $item2->Unit = "piece"; // no more than 50 characters
58 | $item2->UnitPrice = 250;
59 | $item2->ItemTotal = 250;
60 | $item2->SKU = "ITEM-02"; // no more than 100 characters
61 |
62 | // create the transaction
63 | $trans = new PaymentTransactionModel();
64 | $trans->POSTransactionId = "TRANS-02";
65 | $trans->Payee = $myEmailAddress; // no more than 256 characters
66 | $trans->Total = 1500;
67 | $trans->Comment = "Test Transaction"; // no more than 640 characters
68 | $trans->AddItem($item1); // add the items to the transaction
69 | $trans->AddItem($item2);
70 |
71 | // create the shipping address
72 | $shippingAddress = new ShippingAddressModel();
73 | $shippingAddress->Country = "HU";
74 | $shippingAddress->Region = null;
75 | $shippingAddress->City = "Budapest";
76 | $shippingAddress->Zip = "1111";
77 | $shippingAddress->Street = "Teszt utca 1.";
78 | $shippingAddress->Street2 = "1. emelet 1. ajto";
79 | $shippingAddress->Street3 = "";
80 | $shippingAddress->FullName = "Teszt Tibor";
81 |
82 | // create the request model
83 | $psr = new PreparePaymentRequestModel();
84 | $psr->GuestCheckout = true; // we allow guest checkout
85 | $psr->PaymentType = PaymentType::Reservation; // we want an immediate payment
86 | $psr->ReservationPeriod = "1:00:00:00"; // money is reserved for one day
87 | $psr->PaymentWindow = "00:20:00"; // the payment must be completed in 20 minutes
88 | $psr->FundingSources = array(FundingSourceType::All); // both Barion wallet and bank card accepted
89 | $psr->PaymentRequestId = "TESTPAY-02"; // no more than 100 characters
90 | $psr->PayerHint = "user@example.com"; // no more than 256 characters
91 | $psr->Locale = UILocale::EN; // the UI language will be English
92 | $psr->Currency = Currency::HUF;
93 | $psr->OrderNumber = "ORDER-0002"; // no more than 100 characters
94 | $psr->ShippingAddress = $shippingAddress;
95 | $psr->AddTransaction($trans); // add the transaction to the payment
96 |
97 | // send the request
98 | $myPayment = $BC->PreparePayment($psr);
99 |
100 | if ($myPayment->RequestSuccessful === true) {
101 | // redirect the user to the Barion Smart Gateway
102 | header("Location: " . $BC::BARION_WEB_URL_TEST . "?id=" . $myPayment->PaymentId);
103 | }
--------------------------------------------------------------------------------
/library/Enumerations/BarionEnvironment.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum BarionEnvironment : string
22 | {
23 | case Test = "test";
24 | case Prod = "prod";
25 | }
--------------------------------------------------------------------------------
/library/Enumerations/CardType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum CardType : string
22 | {
23 | case Unknown = "Unknown";
24 | case Mastercard = "Mastercard";
25 | case Maestro = "Maestro";
26 | case Visa = "Visa";
27 | case Electron = "Electron";
28 | case AmericanExpress = "AmericanExpress";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/Currency.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum Currency : string
22 | {
23 | case Unspecified = "Unspecified";
24 | case HUF = "HUF";
25 | case EUR = "EUR";
26 | case USD = "USD";
27 | case CZK = "CZK";
28 | }
--------------------------------------------------------------------------------
/library/Enumerations/FundingSourceType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum FundingSourceType : string
22 | {
23 | case All = "All";
24 | case Balance = "Balance";
25 | case Bankcard = "Bankcard";
26 | case BankTransfer = "BankTransfer";
27 | case ApplePay = "ApplePay";
28 | case GooglePay = "GooglePay";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/PaymentStatus.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum PaymentStatus : string
22 | {
23 | case Prepared = "Prepared";
24 | case Started = "Started";
25 | case InProgress = "InProgress";
26 | case Waiting = "Waiting";
27 | case Reserved = "Reserved";
28 | case Authorized = "Authorized";
29 | case Canceled = "Canceled";
30 | case Succeeded = "Succeeded";
31 | case Failed = "Failed";
32 | case PartiallySucceeded = "PartiallySucceeded";
33 | case Expired = "Expired";
34 | }
--------------------------------------------------------------------------------
/library/Enumerations/PaymentType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum PaymentType : string
22 | {
23 | case Immediate = "Immediate";
24 | case Reservation = "Reservation";
25 | case DelayedCapture = "DelayedCapture";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/QRCodeSize.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum QRCodeSize : string
22 | {
23 | case Small = "Small";
24 | case Normal = "Normal";
25 | case Large = "Large";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/RecurrenceResult.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum RecurrenceResult : string
22 | {
23 | case None = "None";
24 | case Successful = "Successful";
25 | case Failed = "Failed";
26 | case NotFound = "NotFound";
27 | case ThreeDSAuthenticationRequired = "ThreeDSAuthenticationRequired";
28 | }
29 |
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/AccountChangeIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum AccountChangeIndicator : string
22 | {
23 | case Unspecified = "";
24 | case ChangedDuringThisTransaction = "ChangedDuringThisTransaction";
25 | case LessThan30Days = "LessThan30Days";
26 | case Between30And60Days = "Between30And60Days";
27 | case MoreThan60Days = "MoreThan60Days";
28 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/AccountCreationIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum AccountCreationIndicator : string
22 | {
23 | case Unspecified = "";
24 | case NoAccount = "NoAccount";
25 | case CreatedDuringThisTransaction = "CreatedDuringThisTransaction";
26 | case LessThan30Days = "LessThan30Days";
27 | case Between30And60Days = "Between30And60Days";
28 | case MoreThan60Days = "MoreThan60Days";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/AvailabilityIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum AvailabilityIndicator : string
22 | {
23 | case Unspecified = "";
24 | case MerchandiseAvailable = "MerchandiseAvailable";
25 | case FutureAvailability = "FutureAvailability";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/ChallengePreference.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum ChallengePreference : string
22 | {
23 | case Unspecified = "";
24 | case NoPreference = "NoPreference";
25 | case ChallengeRequired = "ChallengeRequired";
26 | case NoChallengeNeeded = "NoChallengeNeeded";
27 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/DeliveryTimeframeType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum DeliveryTimeframeType : string
22 | {
23 | case Unspecified = "";
24 | case ElectronicDelivery = "ElectronicDelivery";
25 | case SameDayShipping = "SameDayShipping";
26 | case OvernightShipping = "OvernightShipping";
27 | case TwoDayOrMoreShipping = "TwoDayOrMoreShipping";
28 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/PasswordChangeIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum PasswordChangeIndicator : string
22 | {
23 | case Unspecified = "";
24 | case NoChange = "NoChange";
25 | case ChangedDuringThisTransaction = "ChangedDuringThisTransaction";
26 | case LessThan30Days = "LessThan30Days";
27 | case Between30And60Days = "Between30And60Days";
28 | case MoreThan60Days = "MoreThan60Days";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/PaymentMethodIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum PaymentMethodIndicator : string
22 | {
23 | case Unspecified = "";
24 | case NoAccount = "NoAccount";
25 | case ThisTransaction = "ThisTransaction";
26 | case LessThan30Days = "LessThan30Days";
27 | case Between30And60Days = "Between30And60Days";
28 | case MoreThan60Days = "MoreThan60Days";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/PurchaseType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum PurchaseType : string
22 | {
23 | case Unspecified = "";
24 | case GoodsAndServicePurchase = "GoodsAndServicePurchase";
25 | case CheckAcceptance = "CheckAcceptance";
26 | case AccountFunding = "AccountFunding";
27 | case QuasiCashTransaction = "QuasiCashTransaction";
28 | case PrePaidVacationAndLoan = "PrePaidVacationAndLoan";
29 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/ReOrderIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum ReOrderIndicator : string
22 | {
23 | case Unspecified = "";
24 | case FirstTimeOrdered = "FirstTimeOrdered";
25 | case ReOrdered = "ReOrdered";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/RecurrenceType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum RecurrenceType : string
22 | {
23 | case MerchantInitiatedPayment = "MerchantInitiatedPayment";
24 | case OneClickPayment = "OneClickPayment";
25 | case RecurringPayment = "RecurringPayment";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/ShippingAddressIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum ShippingAddressIndicator : string
22 | {
23 | case Unspecified = "";
24 | case ShipToCardholdersBillingAddress = "ShipToCardholdersBillingAddress";
25 | case ShipToAnotherVerifiedAddress = "ShipToAnotherVerifiedAddress";
26 | case ShipToDifferentAddress = "ShipToDifferentAddress";
27 | case ShipToStore = "ShipToStore";
28 | case DigitalGoods = "DigitalGoods";
29 | case TravelAndEventTickets = "TravelAndEventTickets";
30 | case Other = "Other";
31 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/ShippingAddressUsageIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum ShippingAddressUsageIndicator : string
22 | {
23 | case Unspecified = "";
24 | case ThisTransaction = "ThisTransaction";
25 | case LessThan30Days = "LessThan30Days";
26 | case Between30And60Days = "Between30And60Days";
27 | case MoreThan60Days = "MoreThan60Days";
28 | }
--------------------------------------------------------------------------------
/library/Enumerations/ThreeDSecure/SuspiciousActivityIndicator.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations\ThreeDSecure;
20 |
21 | enum SuspiciousActivityIndicator : string
22 | {
23 | case Unspecified = "";
24 | case NoSuspiciousActivityObserved = "NoSuspiciousActivityObserved";
25 | case SuspiciousActivityObserved = "SuspiciousActivityObserved";
26 | }
--------------------------------------------------------------------------------
/library/Enumerations/TransactionStatus.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum TransactionStatus : string
22 | {
23 | case Prepared = "Prepared";
24 | case Started = "Started";
25 | case Succeeded = "Succeeded";
26 | case Timeout = "Timeout";
27 | case ShopIsDeleted = "ShopIsDeleted";
28 | case ShopIsClosed = "ShopIsClosed";
29 | case Rejected = "Rejected";
30 | case RejectedByShop = "RejectedByShop";
31 | case Storno = "Storno";
32 | case Reserved = "Reserved";
33 | case Deleted = "Deleted";
34 | case Expired = "Expired";
35 | case Authorized = "Authorized";
36 | case Reversed = "Reversed";
37 | case InvalidPaymentRecord = "InvalidPaymentRecord";
38 | case PaymentTimeOut = "PaymentTimeOut";
39 | case InvalidPaymentStatus = "InvalidPaymentStatus";
40 | case PaymentSenderOrRecipientIsInvalid = "PaymentSenderOrRecipientIsInvalid";
41 | case Unknown = "Unknown";
42 | }
--------------------------------------------------------------------------------
/library/Enumerations/TransactionType.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum TransactionType : string
22 | {
23 | case Commission = "Commission";
24 | case Shop = "Shop";
25 | case TransferToExistingUser = "TransferToExistingUser";
26 | case TransferToTechnicalAccount = "TransferToTechnicalAccount";
27 | case TransferFromTechnicalAccount = "TransferFromTechnicalAccount";
28 | case Storno = "Storno";
29 | case WithdrawFee = "WithdrawFee";
30 | case ClosureFee = "ClosureFee";
31 | case StornoBankTransferFee = "StornoBankTransferFee";
32 | case CashDepositFee = "CashDepositFee";
33 | case ForeignDepositFee = "ForeignDepositFee";
34 | case ForeignWithdrawFee = "ForeignWithdrawFee";
35 | case ForeignClosureFee = "ForeignClosureFee";
36 | case BankTransferWithdrawFeeStorno = "BankTransferWithdrawFeeStorno";
37 | case Reserve = "Reserve";
38 | case StornoReserve = "StornoReserve";
39 | case CardTopUpFee = "CardTopUpFee";
40 | case CardProcessingFee = "CardProcessingFee";
41 | case GatewayFee = "GatewayFee";
42 | case CardProcessingFeeStorno = "CardProcessingFeeStorno";
43 | case Unspecified = "Unspecified";
44 | case In = "In";
45 | case Withdraw = "Withdraw";
46 | case CashDeposit = "CashDeposit";
47 | case ForeignDeposit = "ForeignDeposit";
48 | case ForeignBankTransferFee = "ForeignBankTransferFee";
49 | case CashBankTransferFee = "CashBankTransferFee";
50 | case CustodyFee = "CustodyFee";
51 | case ForeignWithdraw = "ForeignWithdraw";
52 | case TransferBack = "TransferBack";
53 | case CardTopUp = "CardTopUp";
54 | case CardTopUpBankFee = "CardTopUpBankFee";
55 | case EmoneySubstractionRestore = "EmoneySubstractionRestore";
56 | case CardPayment = "CardPayment";
57 | case Refund = "Refund";
58 | case RefundToBankCard = "RefundToBankCard";
59 | case StornoUnSuccessfulRefundToBankCard = "StornoUnSuccessfulRefundToBankCard";
60 | case UnderReview = "UnderReview";
61 | case ReleaseReview = "ReleaseReview";
62 | case BankTransferPayment = "BankTransferPayment";
63 | case RefundToBankAccount = "RefundToBankAccount";
64 | case StornoUnSuccessfulRefundToBankAccount = "StornoUnSuccessfulRefundToBankAccount";
65 | case BankTransferPaymentFee = "BankTransferPaymentFee";
66 | case BarionBalanceProcessingFee = "BarionBalanceProcessingFee";
67 | }
--------------------------------------------------------------------------------
/library/Enumerations/UILocale.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Enumerations;
20 |
21 | enum UILocale : string
22 | {
23 | case HU = "hu-HU";
24 | case EN = "en-US";
25 | case DE = "de-DE";
26 | case SL = "sl-SI";
27 | case SK = "sk-SK";
28 | case FR = "fr-FR";
29 | case CZ = "cs-CZ";
30 | case GR = "el-GR";
31 | case ES = "es-ES";
32 | }
--------------------------------------------------------------------------------
/library/Exceptions/BarionException.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Exceptions;
20 |
21 | use Exception;
22 |
23 | class BarionException extends Exception
24 | {
25 | /**
26 | * BarionException constructor.
27 | *
28 | * @param string $message
29 | * @param int $errorCode
30 | */
31 | public function __construct(string $message = "", int $errorCode = 0) {
32 | parent::__construct($message, $errorCode);
33 | }
34 | }
--------------------------------------------------------------------------------
/library/Helpers/JSON.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Helpers;
20 |
21 | class JSON {
22 |
23 | /**
24 | * Gets the value of the specified property from the JSON as a string.
25 | *
26 | * @param mixed $json The JSON
27 | * @param string $propertyName
28 | * @return ?string The value of the property as string
29 | */
30 | public static function getString(mixed $json, string $propertyName): ?string
31 | {
32 | if (!isset($json[$propertyName])) {
33 | return null;
34 | }
35 |
36 | $value = $json[$propertyName];
37 |
38 | if (is_array($value) || is_object($value)) {
39 | return null;
40 | }
41 |
42 | return strval($value);
43 | }
44 |
45 | /**
46 | * Gets the value of the specified property from the JSON as an integer number.
47 | *
48 | * @param mixed $json The JSON
49 | * @param string $propertyName
50 | * @return ?int The value of the property as int
51 | */
52 | public static function getInt(mixed $json, string $propertyName): ?int
53 | {
54 | if (!isset($json[$propertyName])) {
55 | return null;
56 | }
57 |
58 | $value = $json[$propertyName];
59 |
60 | if (is_array($value) || is_object($value)) {
61 | return null;
62 | }
63 |
64 | return intval($value);
65 | }
66 |
67 |
68 | /**
69 | * Gets the value of the specified property from the JSON as a floating point number.
70 | *
71 | * @param mixed $json The JSON
72 | * @param string $propertyName
73 | * @return ?float The value of the property as float
74 | */
75 | public static function getFloat(mixed $json, string $propertyName): ?float
76 | {
77 | if (!isset($json[$propertyName])) {
78 | return null;
79 | }
80 |
81 | $value = $json[$propertyName];
82 |
83 | if (is_array($value) || is_object($value)) {
84 | return null;
85 | }
86 |
87 | return floatval($value);
88 | }
89 |
90 | /**
91 | * Gets the value of the specified property from the JSON as a boolean.
92 | *
93 | * @param mixed $json The JSON
94 | * @param string $propertyName
95 | * @return ?bool The value of the property as bool
96 | */
97 | public static function getBool(mixed $json, string $propertyName): ?bool
98 | {
99 | if (!isset($json[$propertyName])) {
100 | return null;
101 | }
102 |
103 | $value = $json[$propertyName];
104 |
105 | if (is_array($value) || is_object($value)) {
106 | return null;
107 | }
108 |
109 | return (bool)$value;
110 | }
111 |
112 | /**
113 | * Gets the value of the specified property from the JSON as an associative array.
114 | *
115 | * @param mixed $json The JSON
116 | * @param string $propertyName
117 | * @return ?array The value of the property as an array
118 | */
119 | public static function getArray(mixed $json, string $propertyName): ?array
120 | {
121 | if (!isset($json[$propertyName])) {
122 | return null;
123 | }
124 |
125 | $value = $json[$propertyName];
126 |
127 | if (is_array($value)) {
128 | return $value;
129 | }
130 |
131 | return null;
132 | }
133 |
134 | /**
135 | * Gets the value of the specified property from the JSON as a standard PHP object.
136 | *
137 | * @param mixed $json The JSON
138 | * @param string $propertyName
139 | * @return ?object The value of the property as object
140 | */
141 | public static function getObject(mixed $json, string $propertyName): ?object
142 | {
143 | if (!isset($json[$propertyName])) {
144 | return null;
145 | }
146 |
147 | $value = $json[$propertyName];
148 |
149 | if (is_object($value)) {
150 | return $value;
151 | }
152 |
153 | return null;
154 | }
155 |
156 | }
--------------------------------------------------------------------------------
/library/Helpers/StringExtension.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Helpers;
20 |
21 | class StringExtension {
22 |
23 | /**
24 | * Helper function to decide if a given string value is null or empty.
25 | *
26 | * @param ?string $string
27 | * @return bool
28 | */
29 | public static function isNullOrEmpty(?string $string) : bool
30 | {
31 | return ($string === null || trim($string) === '');
32 | }
33 |
34 | }
--------------------------------------------------------------------------------
/library/Interfaces/IBarionModel.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Interfaces;
20 |
21 | /*
22 | * Base model interface.
23 | */
24 | interface IBarionModel
25 | {
26 | /**
27 | * Assemble the model from an array representing standard JSON stucture.
28 | *
29 | * @param array $json Associative array returned by json_decode.
30 | * @return void
31 | */
32 | public function fromJson(array $json) : void;
33 | }
--------------------------------------------------------------------------------
/library/Interfaces/IItemContainer.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Interfaces;
20 |
21 | /**
22 | * Interface describing a model that can contain items.
23 | *
24 | * @method void AddItem(object $item)
25 | * @method void AddItems(array $items)
26 | */
27 | interface IItemContainer
28 | {
29 |
30 | }
--------------------------------------------------------------------------------
/library/Interfaces/IPayeeTransactionContainer.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Interfaces;
20 |
21 | /**
22 | * Interface describing a model that can contain payee transactions.
23 | *
24 | * @method void AddPayeeTransaction(object $transaction)
25 | * @method void AddPayeeTransactions(array $transactions)
26 | */
27 | interface IPayeeTransactionContainer
28 | {
29 |
30 | }
--------------------------------------------------------------------------------
/library/Interfaces/IPaymentTransactionContainer.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Interfaces;
20 |
21 | /**
22 | * Interface describing a class that can contain payment transactions.
23 | *
24 | * @method void AddTransaction(object $transaction)
25 | * @method void AddTransactions(array $transactions)
26 | */
27 | interface IPaymentTransactionContainer
28 | {
29 |
30 | }
--------------------------------------------------------------------------------
/library/Models/BaseRequestModel.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Models;
20 |
21 | /**
22 | * Base model of all requests sent towards the Barion API.
23 | */
24 | class BaseRequestModel
25 | {
26 | /**
27 | * The secret key of the shop that is calling the Barion API, used for authentication.
28 | *
29 | * @var string
30 | */
31 | public string $POSKey;
32 | }
--------------------------------------------------------------------------------
/library/Models/BaseResponseModel.php:
--------------------------------------------------------------------------------
1 |
6 | * Licensed under the Apache License, Version 2.0 (the "License");
7 | * you may not use this file except in compliance with the License.
8 | * You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing, software
13 | * distributed under the License is distributed on an "AS IS" BASIS,
14 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 | * See the License for the specific language governing permissions and
16 | * limitations under the License.
17 | */
18 |
19 | namespace Barion\Models;
20 |
21 | use Barion\Helpers\JSON;
22 | use Barion\Models\Error\ApiErrorModel;
23 |
24 | class BaseResponseModel
25 | {
26 | /**
27 | * Array of API error models.
28 | *
29 | * @var array