हाय, हैब्र। बहुत पहले नहीं, हमने एक मॉड्यूल लिखा था जो सोशल नेटवर्क फेसबुक पर 1C-Bitrix पर स्टोर जोड़ता है। मैं अपने अनुभव को साझा करना चाहता हूं, साथ ही साथ आपके स्टोर में फेसबुक क्रेडिट रिसेप्शन स्थापित करने की विशेषताएं - यह कोई फर्क नहीं पड़ता कि यह किस सीएमएस पर लागू है। हम रवाना हो गए!

ऐतिहासिक पृष्ठभूमि

फेसबुक क्रेडिट, फेसबुक सोशल नेटवर्क की आंतरिक मुद्रा है, जो पहली बार 2009 में प्रदर्शित हुई थी, और इस वर्ष के 1 जून से फेसबुक नियमों के अनुसार, केवल एक ही अनुमति दी गई थी। लंबे समय तक, अर्जित ऋण को वापस लेने के लिए रूसी बैंक को जोड़ना असंभव था - रूस बस फेसबुक क्रेडिट को जोड़ने के लिए देशों की सूची में नहीं था।

अर्जित ऋण को वापस लेने के एकमात्र संभावित तरीके या तो पेपाल के माध्यम से निकासी थे ( वर्तमान में पेपाल से रूस में वापस लेने के लिए कोई कानूनी, सफेद और शराबी तरीका नहीं है) या एक विदेशी बैंक के साथ एक खाता खोलना। हालांकि, 27 जून को, रूस कनेक्टिंग भुगतान के रूप में दिखाई दिया, हालांकि यह अभी आधिकारिक सूची में नहीं है । लेकिन हम वास्तव में आशा करते हैं, और तैयार हैं :-)

हम भुगतान को एप्लिकेशन से जोड़ते हैं

हम इस तथ्य से आगे बढ़ेंगे कि आपके पास पहले से ही फेसबुक के लिए एक कार्यशील अनुप्रयोग है, और आपका कार्य क्रेडिट रिसेप्शन को जोड़ना है। इसलिए, अपनी एप्लिकेशन सेटिंग पर जाएं
और "संपादित करें" पर क्लिक करें। "फेसबुक पर" अनुभाग पर जाएं -> क्रेडिट। नई कंपनी पंजीकृत करने के लिए लिंक का अनुसरण करें। अपने संगठन के लिए फ़ील्ड को सावधानीपूर्वक भरें। सबसे दिलचस्प टैब तीसरा है। यह एक बैंक खाता सेटअप है।


बस कुछ टिप्स। फ़ॉर्म कुछ छोटा है, और यदि आप इसे गलत तरीके से भरते हैं, तो यह खेतों का हिस्सा मिटा देता है। इसलिए, मैं "ओके" बटन पर क्लिक नहीं करने की सलाह देता हूं, लेकिन "एक अलग विंडो में खोलें" पर क्लिक करें - इसलिए त्रुटियों के मामले में भी आपको डेटा को फिर से बाधित नहीं करना पड़ेगा। सभी क्षेत्रों में अंग्रेजी भरें। रिक्तियों के बिना SWIFT फ़ील्ड दर्ज करें।


किसी संगठन को पंजीकृत करने के बाद, आप इसे अपने आवेदन में ऋण प्राप्त करने के लिए जोड़ सकते हैं।

टिप्पणी

फेसबुक के नियमों के अनुसार, आप केवल फेसबुक क्रेडिट के लिए वर्चुअल सामान बेच सकते हैं। निजी तौर पर, मुझे यह जानने में दिलचस्पी होगी कि क्यूआर कोड बेचना एक आभासी उत्पाद है (यदि, मान लें, तो इस क्यूआर कोड का उपयोग करके आप फिल्मों में जा सकते हैं या पिज्जा :-) ऑर्डर कर सकते हैं)।
फेसबुक कमीशन 30% है (यह बहुत कुछ है, लेकिन उदाहरण के लिए, ओडनोकलास्निक में) से कम है। सामान्य तौर पर, ऐसी बारीकियां होती हैं जिन पर विचार करने की आवश्यकता होती है जब सामाजिक नेटवर्क पर व्यावसायिक बिक्री रणनीति की योजना बनाते हैं।

फेसबुक क्रेडिट के काम की सामान्य योजना

तो, आइए देखें कि आपके आवेदन में उस समय क्या होता है जब उपयोगकर्ता कुछ भुगतान करने का फैसला करता है और क़ीमती बटन पर क्लिक करता है।


जावास्क्रिप्ट एपीआई कॉल का उपयोग करके आपका एप्लिकेशन फेसबुक एपि माल के भुगतान के लिए एक संवाद बॉक्स बनाता है:

FB.init({appId: <?=$facebookAppID?>, status: true, cookie: true}); function placeOrder() { //    var obj = { method: 'pay', order_info: {"order_id": "<?=$orderId?>"}, purchase_type: 'item' }; FB.ui(obj, callback); } var callback = function(data) { if (data['order_id']) { $("#payment").hide(); $("#result-success").show(); } else if ((data['error_code']) && (data['error_message'].indexOf("User canceled", 0) == -1)) { $("#payment").hide(); $("#result-failure").show(); } else if ((data['error_code']) && (data['error_message'].indexOf("User canceled", 0) != -1)) { $("#result-cancel").show(); } else { $("#result-failure").show(); } }; 

फेसबुक आदेश विवरण प्राप्त करने के लिए आपके आवेदन के सर्वर पक्ष को एक अनुरोध भेजता है:

• item_id - उत्पाद पहचानकर्ता;
• शीर्षक - उत्पाद का नाम;
• विवरण - विवरण;
• image_url - चित्र;
• product_url - उत्पाद पृष्ठ का लिंक;
• मूल्य - मूल्य;
• data - अतिरिक्त डेटा।

जैसा कि आपने देखा, फेसबुक मानता है कि एक उपयोगकर्ता प्रति लेनदेन केवल एक उत्पाद खरीद सकता है। लेकिन कुछ भी आपको टोकरी की पूरी सामग्री को माल के रूप में बनाने से रोकता है।

भुगतान विंडो बंद करने के तुरंत बाद ग्राहक कॉलबैक कहा जाएगा। इसमें, आपको त्रुटि / रद्दीकरण कोड को संसाधित करना होगा, यदि कोई हो, या एक सफल खरीद पर उपयोगकर्ता को बधाई देता है।

आदेश स्वीकार करें

जैसे ही उपयोगकर्ता भुगतान की पुष्टि करता है, क्रम स्थिति बदलने के लिए आपके सर्वर पर एक दोहराया अनुरोध भेजा जाता है। यदि सब कुछ ठीक है, तो आपका कार्य ऑर्डर प्रोसेसर को लागू करना है। उदाहरण के लिए, स्टोर स्वामी को एक आदेश सूचना भेजें, या डेटाबेस में "भुगतान" स्थिति प्रदर्शित करें।

 <?require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php"); if (!CModule::IncludeModule("sale") || !CModule::IncludeModule("iblock")) { echo(" -  !"); require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/epilog_after.php"); die(); } //    $frontendPath = COption::GetOptionString("sibirix.freshshop", "frontend"); $catalogIblockId = COption::GetOptionString("sibirix.freshshop", "catalogIblockId"); $fbcExchange = COption::GetOptionString("sibirix.freshshop", "exchange"); $api_key = COption::GetOptionString("sibirix.freshshop", "facebook_appid"); $secret = COption::GetOptionString("sibirix.freshshop", "facebook_appsecret"); require_once('facebook.php'); // prepare the return data array $data = array('content' => array()); $request = parse_signed_request($_REQUEST['signed_request'], $secret); if ($request == null) { // handle an unauthenticated request here die("empty request\n"); } //    order_id     float         (      ,    FB).    $payloadData = explode('.', $_REQUEST['signed_request'], 2); $payloadData = base64_url_decode($payloadData[1]); preg_match('/\"order_id\"\:([0-9]*)/', $payloadData, $matches); $stringOrderId = $matches[1]; $payload = $request['credits']; // retrieve all params passed in $func = $_REQUEST['method']; $order_info = json_decode($payload['order_info']); if (!empty($order_info) && isset($order_info->order_id)) { $orderId = (int)$order_info->order_id; } if (empty($orderId)) { //   ( ),     order_id  .      order_id $orderRes = CSaleOrder::GetList(array(), array("COMMENTS" => $stringOrderId, "PAYED" => "N"), false, false, array("*")); $orderData = $orderRes->GetNext(); $orderId = $orderData['ID']; } else { //       $orderData = CSaleOrder::GetByID($orderId); } $basketRes = CSaleBasket::GetList(array(), array( "LID" => SITE_ID, "ORDER_ID" => $orderId), false, false, array("*")); $basket = array(); $description = array(); $itemIds = array(); while ($item = $basketRes->GetNext()) { $basket[] = $item; $description[] = iconv(SITE_CHARSET, "UTF-8", $item['~NAME']) . " - " . number_format($item['QUANTITY'], 0) . "."; if (!empty($item['PRODUCT_ID'])) $itemIds[] = $item['PRODUCT_ID']; } if (count($itemIds)) { $res = CIBlockElement::GetList(array(), array("IBLOCK_ID" => $catalogIblockId, "ID" => $itemIds), false, false, array("DETAIL_PICTURE", "PREVIEW_PICTURE")); while ($item = $res->GetNext()) { if (!empty($item['DETAIL_PICTURE'])) { $pictureId = $item['DETAIL_PICTURE']; break; } if (!empty($item['PREVIEW_PICTURE'])) { $pictureId = $item['PREVIEW_PICTURE']; break; } } } if (isset($pictureId)) { $uploadDir = "/" . COption::GetOptionString("main", "upload_dir", "upload") . "/"; $resFile = CFile::GetList(array(), array("ID" => $pictureId)); $ifile = $resFile->Fetch(); $picture = $ifile; $picture['SRC'] = $uploadDir . $ifile["SUBDIR"] . "/" . $ifile['FILE_NAME']; } $picture = CFacebookShop::getThumbImage($picture, CFacebookShop::PRODUCT_PREVIEW_IMG, SITE_TEMPLATE_PATH.'/images'); if ($orderData['PAYED'] == "Y") { //     $data['content']['status'] = 'settled'; } elseif ($func == 'payments_status_update') { // FB  ,     $status = $payload['status']; // write your logic here, determine the state you wanna move to if ($status == 'placed') { $next_state = 'settled'; $data['content']['status'] = $next_state; //   $ret = CSaleOrder::PayOrder($orderId, "Y"); } // compose returning data array_change_key_case $data['content']['order_id'] = $orderId; } else if ($func == 'payments_get_items') { // FB      $item['title'] = ' №' . $orderId . "    " . COption::GetOptionString("main", "site_name"); $item['price'] = ceil($orderData['PRICE'] / $fbcExchange); $item['description'] = implode(", ", $description); $item['image_url'] = "http://" . COption::GetOptionString("main", "server_name") . $picture; $item['product_url'] = "http://" . COption::GetOptionString("main", "server_name") . $picture; $item['order_id'] = $orderId; CSaleOrder::Update($orderId, array("COMMENTS" => $stringOrderId)); $data['content'] = array($item); } // required by api_fetch_response() $data['method'] = $func; // send data back echo json_encode($data); // you can find the following functions and more details // on http://developers.facebook.com/docs/authentication/canvas function parse_signed_request($signed_request, $secret) { list($encoded_sig, $payload) = explode('.', $signed_request, 2); $sig = base64_url_decode($encoded_sig); $data = json_decode(base64_url_decode($payload), true); if (strtoupper($data['algorithm']) !== 'HMAC-SHA256') { error_log('Unknown algorithm. Expected HMAC-SHA256'); return null; } // check signature $expected_sig = hash_hmac('sha256', $payload, $secret, $raw = true); if ($sig !== $expected_sig) { error_log('Bad Signed JSON signature!'); return null; } return $data; } function base64_url_decode($input) { return base64_decode(strtr($input, '-_', '+/')); } require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog_after.php");?> 

भुगतान प्रणाली पंजीकृत करें

हमने विशेष रूप से 1C-Bitrix के माध्यम से आदेशों के लिए भुगतान लिखा है, इसलिए एक ट्रिफ़ल है: मॉड्यूल को स्थापित करते समय 1C-Bitrix भुगतान प्रणालियों की सूची में भुगतान प्रणाली को पंजीकृत करें:

 //    Facebook Credits function InstallPaysystem() { if (!CModule::IncludeModule("sale") || !CModule::IncludeModule("catalog")) { throw new Exception("Can't include sale and catalog modules"); } $paysystemRes = CSalePaySystem::GetList(array(), array("NAME" => "Facebook Credits")); $paysystem = $paysystemRes->GetNext(); if (!empty($paysystem)) { //  ,   ID COption::SetOptionString($this->MODULE_ID, "paysystemId", $paysystem['ID']); return true; } else { $paysystemId = CSalePaySystem::Add(array( "LID" => SITE_ID, "CURRENCY" => CCurrency::GetBaseCurrency(), "NAME" => "Facebook Credits", "ACTIVE" => "N", "DESCRIPTION" => GetMessage("SHOPBOOK_INSTALL_FBC_DESCR") )); COption::SetOptionString($this->MODULE_ID, "paysystemId", $paysystem['ID']); } return true; } 

देखा! हमारा स्टोर फेसबुक क्रेडिट आदि से आभासी धन प्राप्त करने के लिए तैयार है।