Borica Request 4.0

borica_request.php

<?php
/* 
# Borica Request 4.0
Изпращане на заявка за извършване на електронно плащане: [borica_request.php](https://gist.github.com/dimitarminchev/08d8ab833fa481a8cc5c1e365a16c05e)
- Документация: [Borica APGW e-Gateway Resources](https://3dsgate-dev.borica.bg/)
- Автор: [доц. д-р Димитър Минчев](http://www.minchev.eu)
- Eлектронна поща: [[email protected]](mailto:[email protected])
*/

// Gateway
$GATEWAY = "https://3dsgate-dev.borica.bg/cgi-bin/cgi_link"; // Development
// $GATEWAY = "https://3dsgate.borica.bg/cgi-bin/cgi_link"; // Production

// DATA: MAC_GENERAL = TERMINAL, TRTYPE, AMOUNT, CURRENCY, ORDER, DESC, MERCHANT, MERCH_NAME, ADDENDUM, AD.CUST_BOR_ORDER_ID, TIMESTAMP, NONCE, P_SIGN
$TERMINAL = "V1800001"; // Идентификатор на терминала получен от БОРИКА, Размер: 8
$TRTYPE = "1"; // Тип на транзацията: 1, 12, 21, 22, 24, 90, Разпер: 1-2
$AMOUNT =  "1.23"; // Сума на плащането, Формат: xx.xx, Размер: 1-12
$CURRENCY = "BGN"; // Валута на плащането, Размер: 3, Формат: ISO-4217
$ORDER = "001234"; // Номер поръчка, Размер: 6 
$DESC = "Наименование на поръчката"; // Наименование на поръчката, Размер: 8-50
$MERCHANT = "V1800001"; // Идентификатор на търговеца получен от БОРИКА, Размер: 10-15, Тест: $MERCHANT = "1600000001";
$MERCH_NAME = "Наименование на търговеца"; // Наименование на търговеца, Размер: 18
$ADDENDUM = "AD,TD";
$AD_CUST_BOR_ORDER_ID = $ORDER."@".$ORDER; // ORDER + 16 символа
$TIMESTAMP = gmdate("YmdHis"); // Формат: YYYYMMDDHHMMSS, UTC, Размер: 14
$NONCE = strtoupper(bin2hex(openssl_random_pseudo_bytes(16))); // Формиране на сигнатура за подписване, Размер: 1-64
$RFU = "-"; // Резервирано поле за бъдеща употреба
$COUNTRY = "BG"; // Страна, Размер: 2
$MERCH_GMT = "+03"; // Часова зона на търговеца: GMT 3
$MERCH_URL = "https://www.xxx.bg"; // Линк на страницата на търговеца, Размер: 1-250
$BACKREF = "https://www.xxx.bg/borica_response.php"; // Линк при връщане след плащане, Размер: 1-250
$EMAIL = "[email protected]"; // Електронна поща, Размер: 26

// SIGN: MAC_GENERAL = TERMINAL, TRTYPE, AMOUNT, CURRENCY, ORDER, TIMESTAMP, NONCE, RFU
$P_SIGN = 
strlen($TERMINAL).$TERMINAL.
strlen($TRTYPE).$TRTYPE.
strlen($AMOUNT).$AMOUNT.
strlen($CURRENCY).$CURRENCY.
strlen($ORDER).$ORDER.
strlen($TIMESTAMP).$TIMESTAMP.
strlen($NONCE).$NONCE.
$RFU; 

// Информация за цифровия частен ключ
$private_key = '-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQC5z1/LHY1GcX9f
vMOBZPx3edgmqFkPd7eV136Nog9+VeM4UMfg22d64LAwpRHdfFigTPkc9leR68xT
JXGeiiGJSaG+Vb9oUK3yb9W7YMhk1vJy4p2oyo77Sirki4bhh8RPIVWAqeVUgEL/
f5ZuZSNzB2cFkUOknbRwM/j98fft4lgZN/nYkYjW22UaPA7ULEBMxmQUKrJKi04S
PVIG1iKzLh3jVyRsxi+giFrlQ+/jVWA0wJm8B25jsRcwObjL6+MczutVKmaNjaVy
FNkBtLOWSCf4A6i4xOfafWoEx4tEa4Dl5PTqQI4PBvH6SW3lKulfNpa5m1wvnlA3
hFy9IfUPAgMBAAECggEBAJz/stI9yxQ9bEGpjovzlzsgcdngHzhpkG6EocLsryix
S4dXAjxlRp9V4KmJoHnDymLQByFIqJ98XK3YkpNB5apJ0+euLkfm+8NAaZik404J
LNyTzGFFneCIP4vStQo1HFM8ODG53DM1GOcnmCT5QiW8mHjk0AH02vR/haCU5kdR
qQeMBnGAuqOcO3T7QcuK2AMO7BoGrkq0+V58DyCdf1UpeLoi71HCdBpj8FPHcU0H
ScsPUrWXSkJSVj7R68AUtI4Sss3CEk7DbbSLcW1DfmX6esujM/fx1SLc9Bue4Ipa
0ec7wKvvMbLap0gWOOxZGRtxS9ALJ3T75AOjDx38q6ECgYEA86cPMYUePy/l9CEu
F2fsr0LnpB3clwEhhMeIIjKMCTVnPlHMy8Sm9WrRdErKMpsIbOWgeIqUaPPCt3NZ
FTgJnIJnFR4KI5qPOb3ZRA9OI6eliVvdgxe7e/bHe74b/v/uE6378ddtniHCIvgk
6Oi9/luImv3kYzX1pmJr/8VZQdECgYEAwznqU1QiPaUFtZwkb3hIoTcIYlKwIbmP
3HYdsS2p20WHh3XJC9nojABIBgJJYKdACzQyIy1FJJ3ga0fgkSZ5KL1LXmclXXL6
lzdQNIyF/boRP+XC7fB9MNwIClqJCnmciKWE4xCt9GgEiLnJDYnOhGiQ50BuxJFn
RU6RxjAPoN8CgYEA3LmYr/mx/vf7T3/Ha3jAF716b1iF/14M6WaA0soLxkPUtcYQ
yv/paCZOfRVLuzBrH4ueJdUUwUciPGKIbwqG2nvfumeuM7bOzTZJXrimxvIWqirI
rvuO4qwa5uTAI+/h034n4VyRd1GJt3gop75Ab+6oABDFF4NIeGRtBhXX2CECgYB9
/QRCHouyaKsUlt3UqjWFBPT+LwrH2O8EgZ2L2EJD5c0fGF5UrZ4rq4rPhe5A1+62
zEqG9RIoHVLVKR+9zKxoJDFdjQdKFYeuyt2R7BYUtl2ndOmlkIvaWkU+GUtTXUQt
01O9DeiVUAONEQi1GfgS70CEXMqfRI725UuiMSYE1QJ/EkPO8VPbWf+BgKovYFf1
AsStOfMMvrgVn8e/vZmWluaGb40L34Dxuvv3YRk1EsQFirGZ5XDDCm5r8H1IY8Ne
PXnxLP2opIuch1JHQdebFZqN1C68pX6hopEixOmwShhaNXNJ5RN8c9q+4NXIu73n
lKFJBDsxoMVB/VEoVeQEMg==
-----END PRIVATE KEY-----';
$private_pass = '';

/*
// Отваряне на файла съдържащ цифровия частен ключ 
$private_key_file = "private.key";
$fp = fopen($private_key_file, "r"); 
$private_key = fread($fp, filesize($private_key_file)); 
fclose($fp); 
*/

// Подписване на съобщението с цифров сертификат
$private_key_id = openssl_get_privatekey($private_key, $private_pass); 
openssl_sign($P_SIGN, $signature, $private_key_id, OPENSSL_ALGO_SHA256);   
openssl_free_key($private_key_id);   

// Формиране окончателна подписана сигнатура
$P_SIGN = strtoupper(bin2hex($signature)); 

// Формуляр за извършване на плащане
echo<<<EOT
<h1>Borica Request 4.0</h1>
<pre>
GATEWAY: $GATEWAY
TERMINAL: $TERMINAL 
TRTYPE: $TRTYPE 
AMOUNT: $AMOUNT 
CURRENCY: $CURRENCY 
ORDER: $ORDER 
DESC: $DESC 
MERCHANT: $MERCHANT 
MERCH_NAME: $MERCH_NAME 
MERCH_NAME: $ADDENDUM 
AD_CUST_BOR_ORDER_ID: $AD_CUST_BOR_ORDER_ID 
TIMESTAMP: $TIMESTAMP
NONCE: $NONCE 
RFU: $RFU
COUNTRY: $COUNTRY 
MERCH_GMT: $MERCH_GMT 
MERCH_URL: $MERCH_URL
BACKREF: $BACKREF 
EMAIL: $EMAIL 
P_SIGN: $P_SIGN
</pre>
<form action="$GATEWAY" method="post">

    <!-- TERMINAL: 8 -->
    <input type="hidden" name="TERMINAL" value="$TERMINAL" />
    
    <!-- TRTYPE: 1, 12, 21, 22, 24, 90 -->
    <input type="hidden" name="TRTYPE" value="$TRTYPE" />
    
    <!-- AMOUNT: 1-12 -->
    <input type="hidden" name="AMOUNT" value="$AMOUNT" />
    
    <!-- CURRENCY: 3 -->
    <input type="hidden" name="CURRENCY" value="$CURRENCY" />
    
    <!-- ORDER: 6 -->
    <input type="hidden" name="ORDER"  value="$ORDER" />
    
    <!-- DESC: 8-50 -->
    <input type="hidden" name="DESC"  value="$DESC" />
    
    <!-- MERCHANT: 10-15 -->
    <input type="hidden" name="MERCHANT" value="$MERCHANT" />
    
    <!-- MERCH_NAME: 18 -->
    <input type="hidden" name="MERCH_NAME" value="$MERCH_NAME" />
    
    <!-- ADDENDUM -->
    <input type="hidden" name="ADDENDUM" value="$ADDENDUM" />
    
    <!-- AD.CUST_BOR_ORDER_ID -->
    <input type="hidden" name="AD.CUST_BOR_ORDER_ID" value="$AD_CUST_BOR_ORDER_ID" />
    
    <!-- TIMESTAMP: 14 -->
    <input type="hidden" name="TIMESTAMP" value="$TIMESTAMP" />
    
    <!-- NONCE: 64 -->
    <input type="hidden" name="NONCE" value="$NONCE" />
    
    <!-- RFU: - -->
    <input type="hidden" name="RFU" value="-" />
    
    <!-- COUNTRY: 2 -->
    <input type="hidden" name="COUNTRY" value="$COUNTRY" />
    
    <!-- MERCH_GMT: 3 -->
    <input type="hidden" name="MERCH_GMT" value="$MERCH_GMT" />
    
    <!-- MERCH_URL: 1-250 -->
    <input type="hidden" name="MERCH_URL" value="$MERCH_URL" />
    
    <!-- BACKREF: 1-250 -->
    <input type="hidden" name="BACKREF" value="$BACKREF" />
    
    <!-- EMAIL: 26 -->
    <input type="hidden" name="EMAIL" value="$EMAIL" />
    
    <!-- P_SIGN: 512 -->
    <input type="hidden" name="P_SIGN" value="$P_SIGN" />

    <!-- BUTTON -->
    <input type="submit" value="Payment" /> 

</form>
EOT;

Здравейте,
И аз имам проблема с RC -17. Ползвам си private ключа, с който генерирах сертификатите, които бяха изпратени и одобрени от БОРИКА.
Транзакцията ми е TRTYPE 1 и по документацията, както и примера тук, съм използва TERMINAL_ID, TRTYPE, AMOUNT, CURRENCY, TIMESTAMP.
Какъв беше проблема при вас ?

Здравейте, мина скрипта. Благодаря :))

Ето значението на кода:
-17 | The terminal is denied access to the e-Gateway

Пробвайте следното:

• Не оставяйте празни полета, ако оставяте пробвайте да слагате "-" вместо null (примерно при DESC).
• задължителни полета, които трябва да се подават: TRTYPE, COUNTRY, CURRENCY, ADDENDUM, MERCH_GMT , ORDER, AMOUNT, DESC, TIMESTAMP , TERMINAL, MERCHANT, AD.CUST_BOR_ORDER_ID , NONCE, P_SIGN
• Номера на поръчката, която се опитвате да платите трябва да бъде с уникален номер за деня т.е. поръчка 8 не може да се плати 2 пъти на един ден.
• формата трябва да субмитва до: https://3dsgate-dev.borica.bg/cgi-bin/cgi_link
• (най-вероятно е това) Ако пак не става, пишете на съпорта на борика или банката, за която интегрирате и те ще пуснат разрешение, тъй като от грешката се вижда, че на терминала му е отказан достъп, а не че не са верни ключовете или данните.

Здравейте,
получавам следният отговор:

Sorry, due to technical fault your request cannot be processed

Error message: Bad CGI request

Please try once again or visit us later or choose another means of payment.

Наистина ли има проблем с dev сървъра или най-вероятно аз имам проблем някъде ?

Използвам работещ терминал и данни (чрез досегашната криптировка) в тестов режим, да не би да трябва да изисквам нови от банката - TID и ключове заради новата 3DS криптировка ?

Благодаря предварително!

Колона "CART Number" от таблицата с тестовите карти всъщност трябва да бъде "CARD Number", не става въпрос все пак за количка, а разплащателна карта.

Благодаря @budiony бележката е взета под внимание и информацията е коригирана!

Здравейте,

Видях няколко грешки в PHP кода.

Точно под ключа се задава $priv_key_password = ''; но след това се извиква $private_key_pass
При извикване openssl_free_key() се връща грешка Warning: openssl_free_key() expects parameter 1 to be resource, null given

Благодаря @yorgeeBG бележката е взета под внимание и кода е коригиран.
Грешката се е появила по невнимание след няколко корекции.

Актуализация от 04.02.2021: премахване на опция за подаване на заявката MAC_COMMON.

линк към v:3.0 за документа
https://www.unicreditbulbank.bg/media/filer_public/e0/9b/e09b2ad9-bf31-4bbf-8085-ef09f6dcc7b5/borica_ecommerce_cgi_interface_v30_bg_ucb_1.pdf

Трябва във Form-ата да се добавят полета
MERCH_NAME
MERCH_URL

Здравейте,

Това означава ли, че след като клиента си е попълнил данните за плащането, трябва да се зареди нова страница на сайта, но вече с автоматично попълнената формата от скрипта и след това да се направи submit на формата?

Не използвам този код, но малко рандъм въпрос, на който едва ли ще ми отговори някой тук, утре ще питам Борика, но знаете ли дали трябва да се спазва Dailight time saving за стойността която се сетва в MERCH_GMT/merchant timezone?

Актуализация за версия 4.0.
За повече информация: https://3dsgate-dev.borica.bg/

Здравейте,
при схема на подписване MAC_GENERAL от къде се взима поле MERCH_TOKEN_ID. Не го намирам никъде.,

Здравейте, при схема на подписване MAC_GENERAL от къде се взима поле MERCH_TOKEN_ID. Не го намирам никъде.

При формиране на сигнатура за подписване MERCH_TOKEN_ID не е необходим:
SIGNATURE: MAC_GENERAL = TERMINAL, TRTYPE, AMOUNT, CURRENCY, ORDER, TIMESTAMP, NONCE, RFU

Благодаря <https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail> Няма вирусиwww.avast.com <https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail> <#DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2>

…

On Sun, Jul 30, 2023 at 8:46 AM Dimitar Minchev ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ Здравейте, при схема на подписване MAC_GENERAL от къде се взима поле MERCH_TOKEN_ID. Не го намирам никъде. При формиране на сигнатура за подписване MERCH_TOKEN_ID не е необходим: SIGNATURE: MAC_GENERAL = TERMINAL, TRTYPE, AMOUNT, CURRENCY, ORDER, TIMESTAMP, NONCE, RFU — Reply to this email directly, view it on GitHub <https://gist.github.com/dimitarminchev/08d8ab833fa481a8cc5c1e365a16c05e#gistcomment-4645406> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AD3EB54ALBMO2VOL763ASWDXSXYMJBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFQKSXMYLMOVS2I5DSOVS2I3TBNVS3W5DIOJSWCZC7OBQXE5DJMNUXAYLOORPWCY3UNF3GS5DZVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTANJVG43TCMRXU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

-- Best Regards Peter Petrov

Здравейте,
Позволено ли е да вградя https://3dsgate-dev.borica.bg/cgi-bin/cgi_link в iframe на сайта, като нещо от типа:

<iframe src="https://3dsgate-dev.borica.bg/cgi-bin/cgi_link" width="600" height="400" ></iframe>. Може ли някакво примерче. Благодаря предварително!

Здравейте @dimitarminchev, използвах Вашия код за тестови цели, но ако сменя BACKREF, не се актуализира. Има някакъв кеш или нещо друго трябва да се направи?
Благодаря!

Здравейте, получих известие от Борика, че ми изтичат сертификатите и сега с генерирането на новите ми изпратих и нова документация Версия: 5.0 / 29.05.2024 в моято има задължително поле M_INFO:

"Опционален Ннабор от данни по протокола EMV
3DS v.2
Трябва да бъде Base64 Basic-encoded string of
JSON-formatted “parameter”:”value” data.
Задължителни данни

• Име и фамилия на картодържател ( до 45
  символа на латиница),
• е-mail и / или телефонен номер"

и оставам с впечатлението, че трябва да поискам от клиента Името написано на картата с която ще плаща преди да изпратя заявката към Борика !?!?

@smilegalaxy обърни се към банката ако ти е нужна повече информация, но да, вече в m_info е нужно да се подава допълнителна информация като Имена и/или имейл адрес в документацията беше описано кое е задължително. Като информация би следвало да я имаш ако е онлайн магазин. На мен ми е интересно дали тази информация ще бъде сравнявана с истинската която е на картата, за момента си работи с всичко въведено, конкретно за името.

Иначе, аз съм си ъпдейтнал друга библиотека която ползвам https://github.com/dyanakiev-forks/borica-emv-3ds в нея подавам инфото по-следния начин:

        $borica = $this->initBorica();
        $boricaRequest = new SaleRequest();
        $boricaRequest->setTransactionType(TransactionType::SALE)
            ->setAmount($amount)
            ->setCurrency('BGN')
            ->setOrder($borica_6digits_order)
            ->setDescription($description)
            ->setMerchantName($this->merchantName)
            ->setMerchantUrl($this->merchantUrl)
            ->setMerchant($this->merchant)
            ->setTerminal($this->terminal)
            ->setEmail($this->email)
            ->setCountry('bg')
            ->setLanguage('EN')
            ->setMerchantTimezone($this->timezoneOffset)
            ->setTimestamp(time())
            ->setNonce(strtoupper(bin2hex(openssl_random_pseudo_bytes(16))))
            ->setOrderIdentifier($boricaRequest->getOrder().'ORD@<п>')
            ->setAddendum('AD,TD')
                        ->setMInfo(json_encode([
                            'cardholderName' => $payment->cardholder_name,
                            'email' => $payment->cardholder_email,
                        ], JSON_UNESCAPED_UNICODE))
            ->sign($borica);

Бях разбрал, че CardholderName е името изписано на картата, а реално е името на потребителя - данни, които разбира се имам.