PHP SDK
PHP 7.4+เพิ่มการชำระเงินคริปโตในแอป PHP ด้วย Composer
composer require whollycrypto/php-sdkเริ่มต้นใช้งาน
ติดตั้ง รับชำระเงิน และดูแลเซิร์ฟเวอร์ของคุณ
ใช้ VPS Linux ใหม่ที่มีสิทธิ์ root ไม่ใช่เซิร์ฟเวอร์เว็บไซต์/ฐานข้อมูลเดิม ไม่ต้องใช้ Docker คอมไพเลอร์ หรือโหนดบล็อกเชน
| VPS | ขั้นต่ำ ใช้งานเบา | แนะนำ |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| RAM | 2 GB | 4 GB |
| SSD | 20 GB | 60 GB |
ขั้นต่ำเป็นจุดเริ่มต้นสำหรับใช้งานเบาบนอิมเมจ Ubuntu/Debian แบบขั้นต่ำ ไม่ใช่การรับประกันประสิทธิภาพ ขนาดดิสก์รวม Linux แล้ว ควรมีพื้นที่ว่างอย่างน้อย 3 GiB ก่อนติดตั้ง และเผื่ออัปเดต ประวัติ และข้อมูลสำรอง
ตัวติดตั้งแบบเนทีฟต้องใช้ x86-64, systemd 247+ และ Python 3.9+ ไม่รวม ARM64 และ Alpine/OpenRC
เลือกรุ่นที่ผู้ผลิตยังดูแล หากระบบปฏิบัติการต้องการทรัพยากรมากกว่า ให้ยึดตามนั้น: openSUSE Leap 16 ต้องการดิสก์มากกว่า 40 GB
เชนมากขึ้นและใบแจ้งหนี้พร้อมกันมากขึ้นอาจต้องใช้ CPU และ RAM เพิ่ม VPS ใหญ่ขึ้นไม่ได้ยกเลิกโควตา RPC ขั้นตอนติดตั้งมีการทดสอบอัตโนมัติ แต่ยังไม่ได้ทดสอบติดตั้งบน VPS ใหม่ครบทุกดิสทริบิวชัน
ชี้ชื่อโฮสต์เริ่มต้นเหล่านี้ไปยัง VPS หรือเลือกชื่อของคุณเอง:
merchant.example.com: คอนโซลpay.example.com: หน้าชำระเงินapi.example.com: APIใช้ระเบียน DNS-only ระหว่างตั้งค่า เปิด TCP 80/443 ในไฟร์วอลล์ทั้งสองแห่งและให้ SSH เข้าถึงได้ อย่าเปิด PostgreSQL หรือแอปที่พอร์ต 5432/8080 สู่สาธารณะ
bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)ตัวติดตั้งตรวจสอบไฟล์ดาวน์โหลดและตั้งค่า PostgreSQL, Nginx, HTTPS และบริการต่าง ๆ ถ้าชอบคอนเทนเนอร์ ดู การติดตั้ง Docker ซึ่งเป็นทางเลือก.
ต้องการรุ่นเฉพาะไหม? บน VPS ใหม่ ให้เพิ่ม --version 7.8.1 เพื่อติดตั้งรุ่นที่ลงลายเซ็นนั้นโดยตรง หากไม่ระบุ ตัวติดตั้งใช้รุ่นเสถียรล่าสุด
การทำต่อจะเก็บรุ่นที่เลือกและขั้นตอนที่เสร็จแล้ว รวมถึงเมื่อใช้ GitHub สำรอง จะไม่ลดรุ่นการติดตั้งที่มีอยู่
ตรวจดูตัวติดตั้ง เพิ่ม --check ในคำสั่งเพื่อตรวจความเข้ากันได้โดยไม่ติดตั้ง หรือ --help เพื่อดูตัวเลือก
ทำต่อจากความคืบหน้าที่บันทึกไว้โดยไม่แทนที่คีย์หรือการตั้งค่า:
bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resumeโดเมนหลักที่เพิ่มใช้ชื่อบริการเดิมได้ ระเบียน IPv6 ต้องชี้มายัง VPS นี้ด้วย เปิดพร็อกซี Cloudflare หลังจาก ตรวจสอบโดเมนแล้วเท่านั้น.
QR ขอชำระยอดค้างทั้งหมด ค่าคลาดเคลื่อนยอมรับเฉพาะยอดขาด ยังต้องผ่านการยืนยัน
ราคาเสนอใหม่ของสเตเบิลคอยน์ที่รู้จักปัดขึ้น: 1.321 USDC → 1.33 USDC แม้ค่าคลาดเคลื่อนเป็นศูนย์ ขั้นต่ำ: 0.01 โทเคน
ใบแจ้งหนี้เดิม ยอดคงเหลือ และยอดที่เหลือหลังจ่ายบางส่วนยังคงแม่นยำ โทเคนอื่น/ที่กำหนดเองใช้ความละเอียดตามปกติ
เมื่อผู้ดูแลลงทะเบียน ระบบจะลงทะเบียนบัญชีเครดิตด้วยอีเมลของคุณอัตโนมัติ พร้อมเครดิตต้อนรับหนึ่งครั้งมูลค่า 10 USD เทียบเท่า ไม่ต้องใช้รหัสเปิดใช้งาน
สร้างใบแจ้งหนี้ การเปิดใช้งานที่ค้างจะลองใหม่อัตโนมัติ การเชื่อมต่อใหม่จะไม่ให้เครดิตซ้ำ
ข้อมูลเข้าสู่ระบบ Basic Auth ของคุณบันทึกไว้ใน /root/whollycrypto/config/setup-credentials.txt แยกจากอีเมล/รหัสผ่านคอนโซล
โปรเจกต์ใหม่รับค่า สกุลเงินและเขตเวลาเริ่มต้นของระบบ; ร้านใช้สกุลเงินของโปรเจกต์ เขตเวลาของบัญชีเดิมจัดการแยกใน การตั้งค่า → บัญชี
whollycrypto welcome แสดง URL คอนโซลของคุณ
การติดตั้งใหม่ตั้งแต่ 7.0.0 ให้เลือกโหมดระหว่างตั้งค่าผู้ดูแลคนแรก ย้อนกลับไม่ได้ หากต้องการเปลี่ยนโหมดต้องติดตั้งใหม่ การติดตั้งก่อนรุ่น 7 ยังคงเป็นโหมด Merchant แม้ยังไม่มีผู้ดูแล
Merchant: ดำเนินโปรเจกต์และร้านค้าของคุณเอง Operator: โฮสต์ธุรกิจผู้ค้าแยกกันในการติดตั้งเดียว และเก็บค่าธรรมเนียมประมวลผลแบบชำระล่วงหน้าของคุณเอง รวมธุรกิจของคุณด้วยโดยไม่คิดค่าธรรมเนียม Operator ภายใน
การตั้งค่า Operator ขอที่อยู่ที่สี่ เช่น operator.example.com และชื่อผู้ใช้กับรหัสผ่าน Basic Auth ของตัวเอง เลือกชื่อ ชี้ DNS ไปที่ VPS ตรวจ DNS และเปิด HTTPS แผงจะเปิดตรงที่อยู่นั้น ที่อยู่ผู้ค้า หน้าชำระเงิน และ API ยังแยกกัน
ใช้ข้อมูล Basic Auth ของ Operator ใหม่ แล้วใช้อีเมล/รหัสผ่านผู้ดูแล Basic Auth ของผู้ค้าไม่เปลี่ยน การตั้งค่าทำต่อได้หลังเกิดข้อผิดพลาด DNS หรือใบรับรอง ผู้ที่อัปเกรดจาก 7.0.0 ต้องทำขั้นตอนนี้ด้วย ที่อยู่เดิมที่ใช้งานอยู่ยังใช้ได้
ที่อัตรา 3% ใบแจ้งหนี้ 100 EUR ใช้เครดิตผู้ค้า 3 EUR หากสกุลเงินเครดิตต่างกัน ระบบบันทึกอัตราเงินตราทั่วไป ณ เวลาสร้างไว้กับค่าธรรมเนียม
Operator จ่ายค่าธรรมเนียมการติดตั้ง Wholly Crypto ตามปกติแยกต่างหาก เงินลูกค้าไม่ได้แบ่งบนเชน การซื้อเครดิตไม่ถูกคิดค่าธรรมเนียมซ้ำ
การเติมเงินได้เครดิตเฉพาะเมื่อชำระเสร็จและระบบตรวจสอบอัตโนมัติแล้ว การเปิดหน้าชำระเงินหรือยอมรับใบแจ้งหนี้ด้วยตนเองไม่ทำให้ได้เครดิต การย้อนรายการสร้างรายการในสมุดบัญชี การเติมเงินที่ย้อนแล้วกลับมาอีกต้องให้ Operator ตรวจสอบ
เครดิตผู้ค้าที่โฮสต์ต่ำจะหยุด IPN, webhook, การรวบรวมเงิน และการสร้างโปรเจกต์/ร้านใหม่ชั่วคราว ใบแจ้งหนี้ลูกค้าเดิมและการรับเงินยังดำเนินต่อ เครดิตการติดตั้งต่ำอาจหยุดระบบอัตโนมัติของธุรกิจที่โฮสต์ทั้งหมด การปิดผู้ค้ายังบล็อกการเข้าสู่ระบบและใบแจ้งหนี้ใหม่ แต่ยังติดตามการชำระเงินเก่า
นี่คือการแยกในระดับแอป ไม่ใช่ VPS แยกสำหรับผู้ค้าแต่ละราย ผู้ค้าเข้าถึงโปรเจกต์ กระเป๋า ข้อมูลรับรอง API ศูนย์ซื้อขาย หรือเครดิตของกันและกันไม่ได้ ผู้ดูแลเซิร์ฟเวอร์เข้าถึงคีย์กระเป๋าร้อนที่โฮสต์ได้ แจ้งผู้ค้าก่อนเริ่มใช้งาน ใช้โฮสต์ที่ไว้ใจได้ ข้อมูลสำรองอิสระ และทรัพยากรเพียงพอสำหรับงานที่ใช้ร่วมกัน
ใช้ได้ในโหมด Operator ตั้งแต่ 7.1.0
ตั้งแต่ 7.2.0 กระเป๋า จัดการยอดรับ ที่อยู่ และข้อมูลสำรอง; Sweep จัดการการส่งและกฎอัตโนมัติ เก็บ ETH ไว้สำหรับค่าธรรมเนียมโทเคน การเติมเงินของผู้ค้า ติดตามการซื้อของพวกเขา เครดิตที่ส่วนหัวใช้จ่ายค่าธรรมเนียมการติดตั้งแยกต่างหาก ธุรกิจของฉัน เปิดคอนโซลของคุณในแท็บใหม่
เปิด การเงิน สำหรับค่าธรรมเนียมที่ได้รับ ค่าใช้จ่ายการติดตั้งที่ตรวจสอบแล้ว กำไรส่วนต่างโดยประมาณ และเครดิตผู้ค้าปัจจุบัน กรองตามวันที่ ผู้ค้า หรือสกุลเงินรายงาน และส่งออก CSV
รายงานจัดกลุ่มใบแจ้งหนี้ตามการชำระเสร็จครั้งแรกและสะท้อนการย้อนค่าธรรมเนียมล่าสุด ยอดชำระล่วงหน้าไม่ใช่รายได้ ค่าใช้จ่ายธุรกิจตัวเองแยกไว้ รายการค่าธรรมเนียมค้างหรืออัตราที่ขาดทำให้แสดงส่วนต่างที่เกี่ยวข้องไม่ได้ ยอดแปลงใช้อัตราเงินตราทั่วไปปัจจุบันในแคช ไม่รวม gas และต้นทุนดำเนินงาน
เพิ่มผู้ค้า สร้างคำเชิญ ตั้งแต่ 7.3.0 เลือกเครดิตเริ่มต้นฟรีเป็นสกุลเงินเครดิตของผู้ค้าได้ รวมถึงศูนย์ด้วย สิ่งนี้ไม่ได้เติมยอด Operator ของคุณ ส่งคำเชิญทางอีเมล ถูกเลือกไว้เป็นค่าเริ่มต้น
ตั้งค่าผู้ให้บริการ SMTP ใน การตั้งค่า → อีเมลคำเชิญ ก่อน โดยใช้ TLS หรือ STARTTLS การทดสอบการเชื่อมต่อไม่ส่งอีเมล หรือยกเลิกเลือกอีเมลแล้วแชร์ลิงก์เป็นการส่วนตัว หากส่งอีเมลล้มเหลว บัญชีและเครดิตยังอยู่ อย่าสร้างผู้ค้าซ้ำ
หากต้องการลิงก์ใหม่หรือรีเซ็ตรหัสผ่าน เปิด ผู้ค้า → จัดการ → บัญชีผู้ใช้ การที่ SMTP รับอีเมลไม่ได้รับประกันว่าจะถึงกล่องจดหมาย แชร์ Basic Auth ผู้ค้าแยกต่างหาก อย่าแชร์ข้อมูลเข้าสู่ระบบ Operator
คำเชิญใช้ได้ 48 ชั่วโมง ลิงก์รีเซ็ตใช้ได้หนึ่งชั่วโมง แต่ละลิงก์ใช้ได้ครั้งเดียว เปลี่ยนหรือเพิกถอนลิงก์จากหน้าจอเดิมได้ การรีเซ็ตออกจากเซสชันเดิมแต่ยังเปิด 2FA ไว้ ยังต้องใช้ Basic Auth ผู้ค้า
จัดการผู้ค้าที่โฮสต์แบบอัตโนมัติด้วย SDK 2.6.0 และ Wholly Crypto 7.4.0+ เปิด Operator → การตั้งค่า → Operator API แล้วสร้างคีย์ฝั่งเซิร์ฟเวอร์ที่จำกัดขอบเขต
สร้างบัญชีตรงพร้อมรหัสผ่านหรือส่งคำเชิญ จัดการผู้ใช้ โปรเจกต์ ร้าน ค่าธรรมเนียม และเครดิตชำระล่วงหน้าในระบบ อ่านรายงานและสมัครรับเหตุการณ์วงจรชีวิตที่ลงลายเซ็นแล้ว การยินยอมเรื่องการถือครองสินทรัพย์เมื่อเข้าสู่ระบบครั้งแรก 2FA และการแยกผู้ใช้บริการยังคงอยู่
ทุกการเขียนต้องมีคีย์ idempotency ที่บันทึกไว้ การให้เครดิตเป็นการปรับบัญชีภายใน ไม่ใช่เติมเครดิตการติดตั้ง API นี้ไม่รวมข้อมูลลับกระเป๋า การส่งเงิน และการตั้งค่าเซิร์ฟเวอร์
ใช้ api.your-domain.com/v1/operator เก็บคีย์ Operator ไว้ใน backend ของคุณ อย่าไว้ในเบราว์เซอร์หรือให้ผู้ค้าที่โฮสต์
เอกสารอ้างอิงและสิทธิ์ Operator API → · SDK และตัวอย่างอย่างเป็นทางการ →
การตั้งค่า → โทเคน โหลด 250 โทเคนก่อน แล้วจึงโหลดแค็ตตาล็อกที่เหลือ
โปรเจกต์ → กระเป๋า → สำรองทั้งหมด ส่งออก TXT หรือ HTML ออฟไลน์ที่ค้นหาได้พร้อม QR ทั้งสองแบบเปิดเผยคีย์และวลีกู้คืน เก็บสำเนาส่วนตัวไว้นอกเซิร์ฟเวอร์ อย่าแชร์หรืออัปโหลด
root เข้าถึงคีย์ได้ คู่มือกู้คืนกระเป๋า อธิบายที่อยู่ใบแจ้งหนี้ gas เหรียญหลัก และการสำรอง Monero/Lightning ภายนอก
การตั้งค่า → สมุดที่อยู่: บันทึกเชน/ที่อยู่ เหรียญหลักและโทเคนที่ตรงกับ CoinGecko ปรากฏอัตโนมัติ อ่านอย่างเดียวและผู้ดูแลเป็นผู้จัดการ การยอมรับชำระเงินไม่เปลี่ยน
ตัวอ่านโทเคนครอบคลุม 22 เชน ยอดส่วนตัวและส่วนขยาย Bitcoin/CashTokens/Kaspa ต้องใช้สิทธิ์หรือระบบทำดัชนีแยก หากอ่านล้มเหลวจะแสดงข้อผิดพลาด ไม่ใช่ศูนย์
รวบรวมยอดจากใบแจ้งหนี้ไปยังกระเป๋าอื่นด้วย การส่งด้วยตนเองหรือรวบรวมเงินอัตโนมัติ การโอนโทเคนต้องมีเหรียญหลักของเชนเพื่อจ่ายค่าธรรมเนียมด้วย
ราคาไม่พร้อมใช้งาน เกี่ยวกับอัตรา ไม่ใช่ยอดคงเหลือ
มีการตรวจเครือข่าย/จำนวนทศนิยม ราคาใช้ทั่วโปรเจกต์โดยไม่เปลี่ยนราคาเสนอเดิม เพียงแค่ตรงกับแค็ตตาล็อกไม่ได้เปิดใช้ในหน้าชำระเงิน
DEX Screener ต้องมีพูลที่ตรงสัญญา สภาพคล่อง $10,000 และการซื้อขายภายในหนึ่งชั่วโมง อัตรารีเฟรชทุกนาที อัตราที่ล้มเหลวหรือเก่าห้านาทีจะบล็อกราคาเสนอใหม่
ราคา DEX อาจถูกปั่นได้ การตรวจนี้ไม่ใช่การตรวจสอบความปลอดภัย ใช้ ERC-20 มาตรฐานหรือ SPL แบบดั้งเดิมที่ไว้ใจได้ ไม่รองรับ Token-2022/ส่วนขยาย หากไม่มีพูลที่เหมาะสมให้ใช้ราคาคงที่
การตั้งค่า → ระบบ → ค่าเริ่มต้นภูมิภาค ตั้งสกุลเงิน/เขตเวลาโปรเจกต์ใหม่และเขตเวลาบัญชีใหม่ การตั้งค่าเดิมและเครดิตไม่เปลี่ยน ยังเลือกสกุลเงินแดชบอร์ดทับได้
เขตเวลาส่วนตัว: การตั้งค่า → บัญชี → แก้ไขผู้ใช้.
ใช้ วิธีชำระเงิน → เลือกสำหรับใบแจ้งหนี้นี้ เพื่อจำกัดเชน/โทเคนที่รับ วิธีชำระเงินทั้งหมดของร้าน ใช้ค่าเริ่มต้นต่อไป
ทดสอบยอดเล็ก ๆ ทุกวิธีก่อนเปิดจริง ตรวจใบแจ้งหนี้ก่อนดำเนินคำสั่งซื้อ URL กลับร้านไม่ใช่หลักฐานการชำระเงิน
สำหรับการเชื่อมต่อระบบ ให้ตรวจสอบ IPN/webhook ที่ลงลายเซ็นและยืนยันสถานะผ่าน API ใบแจ้งหนี้ ให้ถือเหตุการณ์ซ้ำเป็นเหตุการณ์เดียวกัน
API: กรอง payment_methods ด้วย chain_slug และ asset_tickers ตัวเลือกที่ไม่ใช้งานจะถูกข้าม หากไม่ตรงเลยจะใช้ค่าเริ่มต้นร้าน ระบุเฉพาะเชนจะรวมสินทรัพย์ที่เปิดทั้งหมด สัญลักษณ์ที่ซ้ำกันต้องใช้ ID สินทรัพย์ ยังต้องมีกระเป๋าและอัตราแลกเปลี่ยน
ตัวสแกนออฟไลน์? ใบแจ้งหนี้ยังคงวิธีที่ตั้งไว้ระหว่างรอการตรวจพบ ตรวจ API ที่รองรับในการเชื่อมต่อเชน สถานะดีไม่ได้แปลว่าเข้ากับตัวสแกน ค่าเริ่มต้นคือผู้ให้บริการอิสระสองราย
ยังต้องมีกระเป๋า/อัตราแลกเปลี่ยน บริการ Monero/Lightning ต้องออกคำขอชำระเงินได้
ข้อผิดพลาด API/MCP รวมถึง error.details.payment_methods SDK 2.4.0 เพิ่มคำอธิบายที่ปลอดภัย: PHP getPaymentMethodIssues(), Python payment_method_issues, Node paymentMethodIssues. เอกสารอ้างอิงข้อผิดพลาด →
ราคาเสนอคริปโตปัดขึ้นและรวมส่วนต่างราคาของร้าน ใบแจ้งหนี้ที่ตั้งราคาเป็นเงินตราทั่วไปไม่ได้แปลงคริปโตที่รับเป็นยอดธนาคาร
ศูนย์การยืนยันหมายถึงถือว่าชำระเสร็จเมื่อพบ โดยไม่มีการป้องกันจากการยืนยันเครือข่าย ตรวจพบการชำระเหรียญหลัก EVM เป็นการโอนตรง ตรวจการชำระผิดปกติหรือไม่แน่ชัดใน ต้องตรวจสอบ.
ตรวจสอบ การเชื่อมต่อเชน เพื่อดู API ที่เข้ากันได้ ประวัติครบ และผู้ให้บริการอิสระ การตามข้อมูลโหนดดิบให้ทันต้องใช้เวลา API รับเงินทั้งหมด →
การชำระเงิน ยอดคงเหลือ และงานบำรุงรักษาใช้งบการเรียกผู้ให้บริการร่วมกัน การตรวจตอนว่างจะช้าลง ใบแจ้งหนี้เก่ายังติดตามการจ่ายล่าช้า/การจัดเชนใหม่ โดยลดเหลือสูงสุดทุกชั่วโมงหลังตามข้อมูลทัน สัญญาณ WSS ที่มีช่วยเสริมการสแกน HTTP การปิดหน้าชำระเงินไม่หยุดการตรวจพบ โหนดสาธารณะยังมีข้อจำกัด Wholly Crypto ไม่ได้รันโหนด
บล็อกเป็นค่าเริ่มต้น เปิด ร้าน → ใบแจ้งหนี้ → อนุญาตใบแจ้งหนี้ยอดศูนย์ เพื่ออนุญาตยอดศูนย์ที่สร้างเอง/ผ่าน API จะเสร็จทันทีโดยไม่มีการชำระเงิน ที่อยู่รับ ธุรกรรม หรือค่าธรรมเนียมประมวลผล
ร้าน → หน้าชำระเงิน: สี โลโก้ วิธีชำระ ลิงก์ ขนาดตัวอักษรข้อความเปิด/ปิด และการแสดงชื่อโปรเจกต์/ร้าน ร้านใหม่ใช้ดีไซน์ของร้านเริ่มต้น การเปลี่ยนแปลงบันทึกอัตโนมัติ
ตัวอย่างรับชำระเงินไม่ได้ ไม่รองรับ HTML/CSS/JavaScript ที่กำหนดเอง
IPN ส่งทุกเหตุการณ์ใบแจ้งหนี้ ไปยัง URL ร้านหรือ ipn_urlของใบแจ้งหนี้ ส่วน webhook ส่งเหตุการณ์ที่เลือก ทั้งคู่ POST สแนปช็อต JSON เดียวกัน
ควรดำเนินคำสั่งซื้อเมื่อไร? สำหรับการจัดการตามเหตุการณ์ ใช้ event_type = invoice.settled ร่วมกับ status = settled ตรวจสอบใบแจ้งหนี้ปัจจุบันและคำสั่งซื้อ แล้วดำเนินคำสั่งซื้อเพียงครั้งเดียว payment.received เพียงอย่างเดียวไม่พอ
status คือสถานะใบแจ้งหนี้ตอนสร้างเหตุการณ์; event_type บอกว่าเกิดอะไรขึ้น
payment.received + processing แล้วตามด้วย invoice.settled + settled.payment.received และ invoice.settled ทั้งคู่มี settled.ทั้งสองรูปแบบเกิดบนเชนอื่นได้ เป็นคนละเหตุการณ์ ไม่จำเป็นต้องเป็นสองการชำระเงิน อาจใช้ sequence ร่วมกัน แต่มีค่า event_id ต่างกัน ไม่รับประกันลำดับส่ง อย่าบังคับว่าต้องมี processing ก่อน
| สถานะใบแจ้งหนี้ | ความหมาย |
|---|---|
new | รอชำระเงิน |
processing | จ่ายบางส่วนหรือรอผลยืนยันขั้นสุดท้าย |
settled | ยอมรับตามกฎใบแจ้งหนี้หรือยอมรับด้วยตนเอง |
expired | พ้นกำหนดแล้ว ยังติดตามการจ่ายล่าช้าต่อได้ |
invalid | การชำระเงินต้องตรวจสอบหรือถูกปฏิเสธ |
cancelled | ยกเลิกแล้ว ไม่ใช่คืนเงินแล้ว |
เหตุการณ์: invoice.created, payment.received, invoice.processing, invoice.settled, invoice.expired, invoice.invalid, invoice.cancelled. ตารางเหตุการณ์และกฎข้อยกเว้นฉบับเต็ม →
amount_status: none, partial, paid, overpaid. paid รวมค่าคลาดเคลื่อน ไม่ใช่ความสิ้นสุดของธุรกรรม timing_status: on_time หรือ late. resolution: automatic, manually_settled หรือ manually_invalidated ใช้นโยบายข้อยกเว้นของคุณเมื่อ requires_review เป็น true
invoice_id ตรงกับการตอบกลับ API amount, currency และ order_id อธิบายคำสั่งซื้อเดิมของคุณ payment_info เพิ่มรายการโอน จำนวนคริปโตที่แน่นอน ราคาเสนอ/ส่วนต่าง/ค่าคลาดเคลื่อนที่ล็อกไว้ และอัตราเพื่อประกอบการตัดสินใจ ข้อมูลลูกค้าและ metadata เป็นข้อมูลส่วนตัว
paid_chain, paid_asset, paid_payment_method_id, paid_asset_amount, paid_asset_amount_received และ settlement_exchange_rate สรุปการชำระเสร็จสิ้น ค่าเหล่านี้คงเดิม หลักฐาน/ประวัติที่ไม่มีจะคงเป็น null สำหรับยอดรับภายหลังใช้ payment_info หรือ API การชำระเงิน.
ใช้สตริงทศนิยม อย่ารวมสินทรัพย์ต่างชนิดหรือถือว่าเงินที่ยังไม่ยืนยันคือเงินหาย จัดการข้อยกเว้นให้ชัดเจน คำเตือนเพียงอย่างเดียวไม่อนุญาตให้ดำเนินคำสั่งซื้อหรือคืนเงิน การเติม gas ภายในที่ตรวจสอบแล้วไม่ใช่เงินลูกค้าและไม่กระตุ้น payment.received.
ข้อมูลลับสำหรับลงลายเซ็นแยกกัน: ร้าน → IPN ลงลายเซ็นการส่ง IPN รวมถึง ipn_urlที่กำหนดเองของใบแจ้งหนี้ แต่ละ endpoint ใน ร้าน → Webhook มีข้อมูลลับของตัวเอง ซึ่งแสดงตอนสร้างหรือเปลี่ยนใหม่
ทั้งคู่ใช้ Wholly-Signature และตัวตรวจสอบ SDK เดียวกัน แต่ต้องใช้ข้อมูลลับที่ตรง ไม่ใช่คีย์ API การเปลี่ยนข้อมูลลับ IPN ไม่เปลี่ยนข้อมูลลับ webhook
ตรวจเนื้อหาดิบ เวลาประทับ และขอบเขตโปรเจกต์/ร้าน บันทึกอย่างคงทนแล้วตอบ HTTP 2xx worker ตรวจใบแจ้งหนี้ปัจจุบันผ่านโฮสต์ API ที่ตั้งไว้ และดำเนินคำสั่งซื้อครั้งเดียวในธุรกรรมฐานข้อมูล header ไม่ได้ลงลายเซ็น ให้ใช้ข้อมูลระบุตัวตนในเนื้อหาที่ลงลายเซ็นของเวอร์ชัน 2
แบบอิงเหตุการณ์: ตัดรายการซ้ำจาก event_idที่ลงลายเซ็นแล้ว จากนั้นกรอง invoice.settled. SDK แบบอิงสถานะ: รวมรายการตามโปรเจกต์ + invoice_id + sequence แล้วตรวจสถานะโดยไม่ขึ้นกับประเภทเหตุการณ์ อย่าเพิ่มตัวกรองเหตุการณ์หลังรวมรายการนี้ ทั้งสองแบบต้องมีการป้องกันซ้ำระดับคำสั่งซื้อแยกต่างหาก
การลองใหม่คงเนื้อหาและ ID เหตุการณ์เดิม รุ่นเก่าต้องไม่ทับรุ่นใหม่ IPN ลองส่งได้สูงสุดแปดครั้ง การลองใหม่ของ webhook เป็นตัวเลือก เครดิตต่ำหยุดการส่งแจ้งเตือน ไม่ใช่การชำระเงิน
ร้าน → IPN / Webhook → ประวัติ → รายละเอียด แสดงเนื้อหาที่บันทึกและผลลัพธ์ payload หมดอายุหลัง 90 วัน การส่งซ้ำไม่ใช่หลักฐานว่าชำระเสร็จแล้ว
ส่งสินทรัพย์ที่รองรับไป Kraken, Binance หรือ Coinbase เก็บเหรียญไว้หรือ แปลงยอดฝากที่เข้าบัญชีแล้ว เงินตราทั่วไปยังอยู่ที่ศูนย์ซื้อขาย
ยอดฝากขั้นต่ำคิดต่อธุรกรรม ไม่ใช่ต่อการรวบรวมเงิน ยอดฝากต่ำกว่าขั้นต่ำจะหยุดแผน รวบรวมยอดเล็กเข้ากระเป๋าของคุณก่อน ซึ่งมีค่าธรรมเนียมเครือข่ายเพิ่ม
ตลาดรีเฟรชทุกสองนาที แปลงได้เฉพาะยอดฝากที่จับคู่และเข้าบัญชีแล้ว ตลาดที่เก่าจะหยุดคำสั่งใหม่ เงินสำรอง 1% ของสินทรัพย์ต้นทางยังอยู่ที่ศูนย์ซื้อขายสำหรับค่าธรรมเนียม/การปัดเศษ แยกจากเครดิตประมวลผล
เก็บยอดขั้นต่ำไว้ สำรองเหรียญ/โทเคนทั่วโปรเจกต์หลังรวบรวมเงินอัตโนมัติ แยกจากเกณฑ์เริ่มทำงาน ศูนย์หมายถึงไม่เก็บ ค่าธรรมเนียมใช้ส่วนเกิน การส่งด้วยตนเองไม่เปลี่ยน
ทำธุรกรรมที่ผลไม่แน่ชัดต่อ อย่าสร้างแทน กระเป๋ายังถูกจองจนยืนยันหรือราคาเสนอที่ไม่ได้ใช้หมดอายุ การรวบรวมเงินจำนวนมากต้องแบ่งเป็นชุด
อยู่ภายใต้การรับฝากสินทรัพย์ KYC ข้อจำกัดภูมิภาค และค่าธรรมเนียมของศูนย์ซื้อขาย ไม่มีการจ่ายเข้าธนาคารหรือเลเวอเรจ เครดิตต่ำหยุดการแปลงใหม่ แต่คำสั่งที่ส่งแล้วยังตรวจสอบกระทบยอด
คุณยังรับชำระเงินได้เมื่อเครดิตหมด ร้านเดิมยังมีใบแจ้งหนี้ หน้าชำระเงิน และการติดตามการชำระเงิน การไม่มีการเชื่อมต่อเรียกเก็บค่าธรรมเนียมที่ยืนยันแล้วหรือถูกระงับบัญชีต่างออกไป และอาจบล็อกใบแจ้งหนี้ใหม่
| ยังใช้ได้ | หยุดชั่วคราวเมื่อไม่มีเครดิตใช้ได้ |
|---|---|
| ใบแจ้งหนี้ หน้าชำระเงิน และการยืนยัน | IPN/webhook รวมการลองใหม่ |
| กระเป๋า ยอดคงเหลือ และข้อมูลสำรอง | Sweep: ส่งเงิน gas คืนเงิน และการแปลงผ่านศูนย์ซื้อขายใหม่ |
| รายงาน API อ่าน และการตั้งค่าเดิม | สร้างโปรเจกต์และร้าน |
| ตรวจหาอัปเดตและกู้คืนอัปเดตที่ขัดจังหวะ | ติดตั้งรุ่นใหม่ |
เติมผ่านไอคอนเครดิต หลังยืนยันว่ายอดกลับมาเพียงพอ ระบบอัตโนมัติที่เปิดจะทำต่อ รวมกฎรวบรวมเงินที่ส่งเงินจริง ปิดกฎที่ไม่ต้องการให้กลับมาทำงาน
เปิด เติมอัตโนมัติ หลังคำขอ เลือกกระเป๋ารับที่สำรองแล้ว เกณฑ์ยอด จำนวนซื้อ วงเงินรายวัน และเพดานค่าธรรมเนียมเครือข่าย อนุญาตแล้วบันทึก เริ่มต้นในสถานะปิด
ใช้ BTC, ETH หรือ USDC/USDT บน Ethereum เมื่อมีให้เลือก ที่อยู่ส่งโทเคนต้องมี ETH กฎนี้ไม่เติม gas ที่ขาด Operator ใช้กระเป๋ารับเฉพาะ ผู้ค้าที่โฮสต์จ่ายให้ Operator ของตน
การเติมที่อนุมัติแล้วทำงานได้แม้เครดิตต่ำจน Sweep หยุด มีเพียงบริการผู้รับที่ยืนยันเครดิต ซื้ออัตโนมัติได้ครั้งละรายการ การปิดหยุดงานที่ยังไม่ส่ง ไม่ใช่ธุรกรรมที่ส่งแล้ว
ใน เติมอัตโนมัติ ใช้ ตรวจสอบการชำระเงิน ทำรายการเดิมที่ยังใช้ได้ต่อ หรือปิดการโอน Ethereum ที่ยืนยันว่าล้มเหลวแล้วและพักกฎ การชำระที่ค้างหรือผลไม่แน่ชัดจะถูกพักเพื่อป้องกันส่งซ้ำ ราคาเสนอหมดอายุไม่ใช่หลักฐานว่าล้มเหลว
อัตราเริ่มต้น 1% คิดจากมูลค่าเงินตราทั่วไปเดิมของใบแจ้งหนี้ที่ชำระเสร็จ เงินคริปโตของลูกค้าไม่ได้แบ่งออก
ค่าธรรมเนียมสะสมต่อจนยอดติดลบ ชำระยอดติดลบแล้วเติมให้เครดิตใช้ได้สูงกว่าเกณฑ์ผ่อนผันของบัญชี ปกติยอดเปลี่ยนภายใน 10–15 วินาทีเมื่อเชื่อมต่อได้ดี
ติดตั้งอัปเดตต้องมีเครดิตที่ยืนยันแล้วมากกว่าศูนย์ แม้มีวงเงินผ่อนผันสำหรับระบบอัตโนมัติ การเติมเงินไม่ติดตั้งอัปเดตอัตโนมัติ
การแจ้งเตือนที่พักไว้ไม่นับครั้งลองส่ง รายการที่เก็บไว้จะทำต่อและยังหมดอายุตามปกติ กระทบยอดเหตุการณ์ที่ตกหล่นผ่าน API ใบแจ้งหนี้
หาก Operator ปิดค่าธรรมเนียมประมวลผล จะไม่มีค่าธรรมเนียมใหม่หรือข้อจำกัดเครดิต ค่าใช้จ่ายเดิมยังอยู่ในประวัติ การติดตั้งที่ยังไม่จับคู่ตั้งค่าโปรเจกต์/ร้านได้ แต่ต้องยืนยันการเรียกเก็บค่าธรรมเนียมก่อนออกใบแจ้งหนี้ ใบแจ้งหนี้ที่ออกแล้วยังถูกติดตาม
กราฟรายได้และตัวกรองอยู่เหนือแท็บ: โปรเจกต์และร้าน, ใบแจ้งหนี้, กระเป๋า และ การรวบรวมเงิน ค้นหาด้านล่าง โปรเจกต์และร้านส่งออก CSV ได้ ช่วงวันที่กำหนดเองได้สูงสุด 366 วัน กระเป๋าใช้ยอดในแคช
เข้าถึงแบบสมัครใจและจำกัดตามโปรเจกต์ที่ api.example.com/mcp อ่านการชำระเงินหรืออนุมัติการสร้างใบแจ้งหนี้ ตั้งค่าและสิทธิ์ MCP →
ใช้ SDK อย่างเป็นทางการเพื่อสร้างใบแจ้งหนี้ ตรวจการชำระเงิน และตรวจสอบ IPN/webhook
เพิ่มการชำระเงินคริปโตในแอป PHP ด้วย Composer
composer require whollycrypto/php-sdkเชื่อมต่อแอป Python หรือ backend โดยไม่มีไลบรารีพึ่งพาขณะรัน
python -m pip install whollycryptoJavaScript หรือ TypeScript ในแพ็กเกจ npm เดียวพร้อมชนิดข้อมูลในตัว
npm install whollycryptoเพิ่มสาขา main ใน Xcode ตั้งค่า Swift และความปลอดภัยแอป →
https://github.com/whollycrypto-com/whollycrypto-swift-sdk.gitใช้โดเมน API ของการติดตั้งคุณและเก็บคีย์ API ฝั่งเซิร์ฟเวอร์ SDK ทั้งหมดใช้สัญญาอนุญาต MIT
เปิด โปรเจกต์ → เครื่องมือชำระเงิน แล้วเลือกร้าน แชร์ลิงก์ชำระเงินที่ใช้ซ้ำ รับชำระที่จุดขาย หรือตั้งเวลาส่งคำขอชำระทางอีเมล
หน้าตาร้าน การยืนยัน และ callback ยังมีผล การพักเครื่องมือหยุดคำขอใหม่ ไม่หยุดการชำระเดิม ประวัติลิงก์ไปแต่ละใบแจ้งหนี้ ช่วงที่พลาดจะไม่ส่งอีเมลถล่มตามมา การส่งซ้ำใช้ใบเดิมที่ยังไม่จ่ายและไม่หมดอายุ
หน้าชำระเงินลูกค้า ลิงก์ชำระเงิน และอีเมลตามกำหนดรองรับอังกฤษ เยอรมัน สเปน โปรตุเกสบราซิล อิตาลี รัสเซีย จีนตัวย่อ ฝรั่งเศส เกาหลี และญี่ปุ่น
ร้าน → ใบแจ้งหนี้ → ภาษาหน้าชำระเงิน ตั้งค่าเริ่มต้นได้ เปลี่ยนทับเฉพาะใบแจ้งหนี้หรือเครื่องมือชำระเงินได้ อีเมลและการส่งซ้ำคงภาษาใบแจ้งหนี้ ข้อความของคุณไม่เปลี่ยน คอนโซล Merchant และ Operator ยังเป็นอังกฤษ
ใน การตั้งค่า → ระบบ ใต้ข้อจำกัด IP ต้นทาง เปิด SMTP ด้วยชื่อโฮสต์สาธารณะ ข้อมูลเข้าสู่ระบบ ผู้ส่ง และที่อยู่ตอบกลับถ้าต้องการ ใช้ TLS พอร์ต 465 หรือ STARTTLS พอร์ต 587
บันทึก ทดสอบการเชื่อมต่อ แล้วส่งอีเมลทดสอบให้ตัวเอง ตั้ง SPF/DKIM กับผู้ให้บริการ การที่ SMTP รับไม่ได้รับประกันว่าจะเข้ากล่องจดหมาย
คำขอตามกำหนดใช้ SMTP ระบบ ช่องทางแจ้งเตือนเลือกใช้ได้เช่นกัน การตั้งค่าช่องทางเดิมและคำเชิญ Operator ไม่เปลี่ยน มีเพียงผู้ดูแลการติดตั้งที่จัดการข้อมูลรับรองที่เข้ารหัสเหล่านี้ได้ หากส่งอีเมลล้มเหลวต้องสั่งส่งซ้ำโดยชัดแจ้ง
กระดิ่งเปิดกล่องแจ้งเตือน ตัวเลือกธีมอยู่ในเมนูการตั้งค่า
ปัญหาซ้ำจะรวมกลุ่ม ประวัติเก็บ 30 วัน สิทธิ์โปรเจกต์ยังมีผล อ่านแจ้งเตือนไม่ได้แก้ปัญหา การแจ้งให้คนอ่านไม่แทน IPN หรือ webhook ของร้าน
เปิด โปรเจกต์ → Marketplace เลือกร้านและลงทะเบียนผู้ขายพร้อมปลายทางที่ตรวจสอบอย่างอิสระ สร้างใบแจ้งหนี้เดียวโดยระบุส่วนแบ่งผู้ขายอย่างแม่นยำ อนุมัติการจ่ายด้วยตนเองหรือตั้งนโยบายอัตโนมัติที่มีขอบเขต
เฉพาะ Bitcoin mainnet และเหรียญ EVM/ERC-20 ที่รองรับ ลูกค้าจ่ายเข้ากระเป๋าที่โปรเจกต์ควบคุมก่อน ไม่ได้จ่ายตรงให้ผู้ขาย เก็บเหรียญหลักที่ไม่ติดภาระไว้จ่ายค่าธรรมเนียม การรวบรวมเงินทั่วไปไม่แตะที่อยู่รับที่ปกป้องไว้
ค่าประมวลผลคิดครั้งเดียวกับใบแจ้งหนี้เดิม แยกจากค่าคอมมิชชันของคุณ การจ่ายขาดและยอดรับที่ไม่แน่ชัดต้องตรวจสอบ การคืนเงินหลังจ่ายผู้ขายต้องใช้เงินแยก ไม่ใช่เรียกคืนจากผู้ขายอัตโนมัติ
ตั้งค่าการชำระเงินสำหรับผู้ขายหลายราย · เอกสารอ้างอิง Marketplace API
เปิด การตั้งค่า → บัญชี เพื่อดูรายงาน ธุรกรรม ส่งออก และตรวจสอบ แดชบอร์ดยังคงแยกต่างหาก
ยอดรับที่ยืนยัน การคืนเงิน และต้นทุนที่บันทึกแยกจากการโอนระหว่างกระเป๋าและซื้อเครดิตล่วงหน้า ยอดใบแจ้งหนี้นับครั้งเดียวแม้มีหลายการชำระ
มูลค่าในอดีตใช้หลักฐานที่เก็บไว้ ไม่ใช่ราคาวันนี้ อัตราเก่าและค่าธรรมเนียมจริงอาจไม่มี ไม่ถือว่าต้นทุนที่ขาดเป็นศูนย์ หากหลักฐานไม่ครบจะแสดงยอดสุทธิไม่ได้
ครอบคลุมระเบียนที่ Wholly Crypto ติดตาม ไม่ใช่ทุกธุรกรรมกระเป๋าหรือศูนย์ซื้อขายภายนอก เป็นเครื่องมือช่วยทำบัญชี ไม่ใช่แบบยื่นภาษีหรืองบกำไร แชร์ไฟล์ส่งออกอย่างปลอดภัย เพราะอาจมีอีเมลลูกค้า
ย้ายเงินที่รับไปปลายทางที่เลือก จัดการกฎและประวัติใน โปรเจกต์ → Sweep.
ส่งเหรียญหลักบน 29 เชน; Monero ยังเป็นแบบดูอย่างเดียว โทเคน: ERC-20 ที่ผ่านการตรวจสอบและ SPL แบบดั้งเดิม การส่งด้วยตนเองและรวบรวมอัตโนมัติใช้มาตรการป้องกันเดียวกัน
นอกจาก BTC, EVM, SOL และ TRX ยังมีตัวเชื่อมต่อเหรียญหลักอีก 18 รายการ ใช้ผู้ให้บริการที่ส่งธุรกรรมได้ ZEC เฉพาะแบบโปร่งใส; ADA เก็บเอาต์พุตที่มีโทเคนไว้; DOT ใช้ Asset Hub; HBAR ต้องมี relay ปลายทางที่ต้องใช้ memo/tag/comment ขาออกต้องใช้กระเป๋าภายนอก
การเติม gas การยืนยัน และส่งโทเคนทำต่อเบื้องหลังหลังอนุมัติ ติดตามที่ กิจกรรมการโอนได้แม้ปิดหน้าต่างแล้ว การกระจายธุรกรรมไม่ใช่การยืนยัน
ETH ที่เก็บไว้ในกระเป๋าโปรเจกต์: 0 ไม่เพิ่มเงินสำรอง ไม่ได้ใช้ ETH ทั้งหมดของคุณ 0.005 เก็บอย่างน้อย 0.005 ETH ไว้ใช้ภายหลัง จึงต้องมีเงินเพิ่มสำหรับขั้นตอนนี้ กฎอัตโนมัติที่บันทึกไม่เปลี่ยน
วงเงินรายวันจำกัด gas เหรียญหลักที่จัดสรรต่อกฎโทเคนในช่วง 24 ชั่วโมงย้อนหลังแบบเลื่อน €1 อาจเป็นวงเงินเริ่มต้นสำหรับใช้งานเบา ไม่ใช่ค่าใช้จ่ายรับประกันหรือค่าธรรมเนียมรายวัน ธุรกรรมเติมเงินก็มีค่าธรรมเนียม ค่าธรรมเนียมเครือข่ายสูงสุด % จำกัดค่าธรรมเนียมเติมเงิน/โอนรวมกันได้
ตรวจโดยอัตโนมัติ เฉพาะที่อยู่ถือโทเคนที่เข้าเกณฑ์จะได้รับ gas ที่อยู่ว่างไม่ได้รับ ที่อยู่ที่ค่าธรรมเนียมไม่พอและต่ำกว่ายอดรวบรวมขั้นต่ำจะรอ อธิบายขีดจำกัด gas →
การส่งถูกปิดอยู่? ตรวจ whollycrypto transfers status ตรวจทุกกฎที่เปิดก่อน whollycrypto transfers enable: มีผลทั้งเซิร์ฟเวอร์และอาจเริ่มกฎที่บันทึกทันที การหยุดขั้นตอนในอนาคตย้อนธุรกรรมที่กระจายแล้วไม่ได้
การตั้งค่า → ระบบ: เลือก จัดการ หรือ เพิ่มโดเมน บันทึก ตรวจ DNS แล้วเผยแพร่ โฮสต์ที่ไม่เปลี่ยนข้ามการตรวจ DNS/SSL
ร้าน → พื้นฐาน: เลือกโฮสต์ merchant/pay/API ที่ใช้งาน ลิงก์เลือกตามร้าน → ร้านเริ่มต้น → ระบบ ชื่อที่เลิกใช้จะใช้ค่าทดแทน ตั้งโฮสต์ SDK แยก การลองส่งที่ลงลายเซ็นแล้วเก็บลิงก์เดิม
HTTPS ทำงานอัตโนมัติ เปิดปิด Cloudflare หลังตั้งค่าได้ Let’s Encrypt ยังทำงาน
/.well-known/acme-challenge/ บนพอร์ต 80 โดยไม่เปลี่ยนเส้นทางหรือทดสอบ เพื่อการต่ออายุการตรวจสอบถาม DNS ที่มีอำนาจและตรวจต้นทาง: โดยตรงหรือ Cloudflare ผู้เยี่ยมชมอาจมี DNS เก่าในแคช
การบันทึก/ลบในคอนโซลใช้ POST ตั้งแต่ 5.6.2 ไม่ต้องยกเว้น “Not GET or POST” การเข้าสู่ระบบและ CSRF ยังทำงาน บน api.* อนุญาตวิธีที่ระบุในเอกสาร API สาธารณะ
ตั้งค่า 2FA ใน การตั้งค่า → บัญชี ผู้ใช้ที่มีสิทธิ์เฉพาะโปรเจกต์ใช้ ความปลอดภัยของฉัน ที่ท้ายหน้า ยืนยันรหัสผ่าน สแกน QR/คีย์ TOTP แล้วกรอกรหัสหกหลัก
ลอง Verifyr Authenticator สำหรับ iOS หรือ Android หรือแอป TOTP มาตรฐานอื่น เก็บรหัสกู้คืนใช้ครั้งเดียวแยกจากรหัสผ่าน เปิดการป้องกัน HTTP Basic ไว้
การเปลี่ยนรหัสหรือปิด 2FA ต้องใช้รหัสผ่านและรหัสจากแอปยืนยันตัวตนหรือรหัสกู้คืนที่ยังไม่ใช้ เซสชันอื่นจะออกจากระบบ ให้นาฬิกาโทรศัพท์/เซิร์ฟเวอร์ตรงกัน 2FA ไม่ป้องกันเซิร์ฟเวอร์ที่ถูกเจาะแล้ว
ไอคอนธีมสลับระหว่าง สว่าง → สลัว → มืด และจำตัวเลือกของเบราว์เซอร์นี้ ธีมหน้าชำระเงินร้านแยกต่างหาก
merchant.* หรือ api.* ที่ใช้งาน ต้องยังอนุญาต IP คอนโซลปัจจุบันpay.* ไว้ ลูกค้าต้องจ่ายจากที่ไหนก็ได้เพิ่มกฎเข้าถึง Cloudflare ได้ตามต้องการ ยกเว้นการทดสอบต่ออายุ HTTPS และหลีกเลี่ยงขั้นตอนทดสอบเข้าสู่ระบบแบบโต้ตอบบน API และหน้าชำระเงิน โหมดพร็อกซีอย่างเดียวไม่ใช่การจำกัด IP
เข้าไม่ได้? เรียกใช้ whollycrypto access-reset --domain merchant.example.com ผ่าน SSH จะเปิดเฉพาะชื่อโฮสต์นั้นภายในห้าวินาที การยืนยันตัวตนบัญชียังเปิดอยู่
whollycrypto ssl
whollycrypto ssl --fixคำสั่งแรกตรวจใบรับรองที่ใช้งาน --fix ซ่อมไฟล์สนับสนุน TLS และต่ออายุใบรับรองที่ขาด/ใกล้หมดอายุ Nginx ต้องทำงาน และเปิดพอร์ต 80/443 ไว้
เรียกใช้ whollycrypto ssl --domain merchant.example.com --reissue เพื่อบังคับเปลี่ยนใหม่ มีข้อจำกัดจำนวนการออก หาก Cloudflare บล็อกการทดสอบ HTTP ให้ใช้ DNS-only ชั่วคราว กระเป๋า การยืนยันตัวตน และโดเมนไม่เปลี่ยน
การตัดสินใจต้องมีเหตุผล คืนเงินต้องโอนแยกและยืนยัน การเปลี่ยนสถานะใบแจ้งหนี้ไม่ส่งเงิน
อ่าน บันทึกประจำรุ่น แล้วใช้ การตั้งค่า → ระบบ → อัปเดตซอฟต์แวร์ หรือ CLI การอัปเดตตรวจลายเซ็น สร้างข้อมูลสำรอง และตรวจสุขภาพระบบ หน้าชำระเงินหยุดชั่วคราวระหว่างติดตั้ง
whollycrypto update --check
whollycrypto updateการอัปเดตรองานเบื้องหลังได้สูงสุดสองนาที โดยหน้าชำระเงินยังออนไลน์ หากหมดเวลารอจะคืนตัวจับเวลา
ตัวอัปเดตเก่าถูกบล็อก? เรียกใช้คำสั่งนี้หนึ่งครั้ง คีย์ที่ติดตั้งไว้จะตรวจสอบตัวช่วย
bash <(curl -fsSL https://releases.whollycrypto.com/update_wholly.sh)เก็บ ข้อมูลสำรองนอกเซิร์ฟเวอร์ ของ PostgreSQL การตั้งค่า คีย์เข้ารหัสกระเป๋า และไฟล์ส่งออกกระเป๋าที่ทดสอบแล้ว ไฟล์กู้คืนภายในเครื่องไม่ได้เข้ารหัส
กู้ข้อมูลสำรองฐานข้อมูล/การตั้งค่าที่คู่กันพร้อมกัน อย่าขัดจังหวะการย้าย schema หรือใช้ไบนารีเก่ากับฐานข้อมูลใหม่กว่า กฎเครดิต ยังมีผล
การติดตั้งและอัปเดตจะลองใช้ มิเรอร์ GitHub ทางการอัตโนมัติ ยังต้องตรวจลายเซ็น checksum และเครดิต
คำสั่ง root ผ่าน SSH
whollycrypto status
whollycrypto doctor
whollycrypto backup| คำสั่ง | จุดประสงค์ |
|---|---|
whollycrypto version | รุ่นที่ติดตั้ง |
whollycrypto status | สุขภาพแอปและฐานข้อมูล |
whollycrypto logs | บันทึกแอป 80 บรรทัดล่าสุด |
whollycrypto restart | รีสตาร์ตและตรวจสุขภาพระบบ |
whollycrypto doctor | ตรวจการติดตั้งแบบอ่านอย่างเดียว |
whollycrypto doctor --fix | ซ่อมสิทธิ์ที่ระบบจัดการและลิงก์ CLI ที่ขาด |
whollycrypto htaccess | รีเซ็ตข้อมูลเข้าสู่ระบบ Basic Auth |
whollycrypto admin-reset | รีเซ็ตรหัสผ่านผู้ดูแล |
whollycrypto 2fa-reset | รีเซ็ตตัวตรวจสอบสองขั้นของบัญชีหนึ่งโดยไม่เปลี่ยนรหัสผ่าน |
whollycrypto transfers statuswhollycrypto transfers enablewhollycrypto transfers disable | ตรวจ เปิด หรือพักการส่งของทุกโปรเจกต์ การเปิดรีสตาร์ตแอปและอาจเรียกกฎที่บันทึกทันที ต้องยืนยัน การอัปเดตคงสถานะพักไว้ |
whollycrypto ssl | ตรวจ HTTPS; เพิ่ม --fix เพื่อซ่อม |
whollycrypto access-reset --domain HOST | นำข้อจำกัด IP ของชื่อโฮสต์หนึ่งออก |
whollycrypto update --check | ตรวจหาอัปเดตที่ลงลายเซ็น |
whollycrypto update | สำรอง อัปเดต และรีสตาร์ต |
whollycrypto backup | ไฟล์สำรองที่เฉพาะ root เข้าถึงได้ใน /root/whollycrypto/backups/releases/. |
whollycrypto recover | กู้คืนงานบำรุงรักษาที่ขัดจังหวะหรืออัปเดตที่ schema ไม่เปลี่ยน ไม่กู้ฐานข้อมูลอัตโนมัติ |
whollycrypto reset | เลือกหนึ่งโปรเจกต์ ทุกโปรเจกต์ธุรกิจ หรือซ่อมอย่างเดียว |
whollycrypto uninstall --checkwhollycrypto uninstall | ดูตัวอย่าง แล้วนำรันไทม์แบบเนทีฟออก ฐานข้อมูล คีย์ และข้อมูลสำรองยังอยู่ |
whollycrypto welcome | URL คอนโซลและลิงก์ |
whollycrypto --help | คำสั่ง; เพิ่ม --help หลังคำสั่งเพื่อดูตัวเลือก |
การตรวจเป็นแบบอ่านอย่างเดียว และจบด้วยรหัสไม่เป็นศูนย์เมื่อต้องตรวจสอบ --fix ซ่อมเฉพาะสิทธิ์ที่จัดการและลิงก์ CLI ที่ขาด ไม่เปลี่ยนการเรียกเก็บค่าธรรมเนียม ลบข้อมูล หรือรีสตาร์ตบริการ
whollycrypto reset
# Preview without changing anything:
whollycrypto reset --scope business --check
whollycrypto reset --scope project --project YOUR_PROJECT_IDENTIFIER --checkเลือกหนึ่งโปรเจกต์ ทุกโปรเจกต์ธุรกิจ หรือซ่อมอย่างเดียว การรีเซ็ตโปรเจกต์ลบโปรเจกต์ ร้าน ระเบียนกระเป๋า และประวัติการชำระเงินที่เลือกอย่างถาวร ซ่อมอย่างเดียวตรวจและแก้สิทธิ์ที่จัดการกับลิงก์ CLI
ปิดโปรเจกต์ที่เลือก จัดการการชำระ/โอนที่ค้าง และย้ายยอดกระเป๋าที่ทราบก่อน บัญชี โดเมน โหนด เครดิต ตัวตนเรียกเก็บค่าธรรมเนียม และโหมดการติดตั้งยังอยู่ กระเป๋ารับ Operator และระเบียนเครดิตผู้ค้าที่โฮสต์ถูกปกป้อง ไม่เปิดตัวช่วยตั้งค่าใหม่
การรีเซ็ตที่ลบข้อมูลต้องพิมพ์ยืนยัน และสร้างข้อมูลสำรองกู้คืนที่ตรวจสอบแล้วก่อนลบ เก็บสำรองกระเป๋านอกเซิร์ฟเวอร์ด้วย ที่อยู่เก่ายังรับเงินได้ แต่โปรเจกต์ที่ลบจะหยุดติดตาม ยอดในแคชไม่ได้พิสูจน์ว่ากระเป๋าว่าง
whollycrypto uninstall --check
whollycrypto uninstallหยุดหน้าชำระเงิน API และ worker; นำไฟล์รันไทม์และส่วนเชื่อมต่อเซิร์ฟเวอร์ที่จัดการออกหลังสำรองและพิมพ์ยืนยัน การชำระหรือโอนที่ค้างบล็อกการนำออก ไฟล์จะย้ายเข้าข้อมูลสำรองกู้คืน ไม่ใช่ลบทิ้ง
ฐานข้อมูล การตั้งค่า คีย์ และข้อมูลสำรองยังอยู่ ไม่แตะแพ็กเกจ Nginx/PostgreSQL ที่ใช้ร่วมกันและใบรับรอง TLS คำสั่งแสดงคำสั่งกู้คืนแบบออฟไลน์ อย่ารันติดตั้งใหม่ทับข้อมูลที่เก็บไว้
คำสั่งรีเซ็ต/นำออกใช้กับการติดตั้ง VPS แบบเนทีฟ ไม่ใช่ Docker หรือ Umbrel สำหรับคอนเทนเนอร์ให้ใช้คำสั่งสำรองและหยุดของระบบเชื่อมต่อ แล้วเก็บโวลุ่มไว้ ทั้งสองคำสั่งลบข้อมูลไม่ยอมรับ --yes.
whollycrypto htaccessเลือกผู้ใช้ ตั้งชื่อ/รหัสผ่าน และยืนยัน สิ่งนี้รีเซ็ตหน้าถามเข้าสู่ระบบแรกของเบราว์เซอร์ ไม่ใช่บัญชีคอนโซล ผู้ใช้อื่นและข้อมูลรับรอง API ไม่เปลี่ยน
whollycrypto admin-resetเลือกผู้ดูแลตามอีเมลและยืนยันรหัสผ่านใหม่ ล้างเซสชันและการล็อกเข้าสู่ระบบบัญชี ข้อจำกัด IP ยังคงอยู่
รีเซ็ตปกติคง 2FA หากทั้งตัวตรวจสอบและรหัสกู้คืนสูญหาย ให้เรียกใช้โดยชัดแจ้ง whollycrypto admin-reset --email admin@example.com --reset-2fa ตั้ง 2FA อีกครั้งหลังเข้าสู่ระบบ
ต้องมีฐานข้อมูล ไม่ต้องมีแอปหรือรหัสผ่านเดิม บัญชีอื่น กระเป๋า และสิทธิ์ไม่เปลี่ยน บัญชีที่ปิดยังปิดอยู่
ทำตัวตรวจสอบและรหัสกู้คืนหายทั้งคู่? เลือกบัญชีด้วยสิทธิ์ root
whollycrypto 2fa-reset
# Or select the account directly:
whollycrypto 2fa-reset --email user@example.comนำเซสชัน ตัวตรวจสอบ และรหัสกู้คืนออก เข้าสู่ระบบด้วยรหัสผ่านเดิมแล้วตั้ง 2FA ใหม่ สิทธิ์ กระเป๋า และ Basic Auth ไม่เปลี่ยน บัญชีที่ปิดยังปิดอยู่
ต้องมีฐานข้อมูล ไม่ต้องมีแอปหรือเครดิต แบบไม่โต้ตอบ: --email และ --yes.
กด Enter เพื่อสร้างรหัสผ่านใน /root/whollycrypto/config/credential-resets/: เป็นส่วนตัว ไม่เข้ารหัส ใช้ได้หลังสำเร็จ รหัสผ่านที่กรอกเองไม่ถูกบันทึก
whollycrypto htaccess --user admin --new-user operator
whollycrypto admin-reset --email admin@example.comหากไม่มีเทอร์มินัล ให้ระบุบัญชีที่มีพร้อม --generate หรือ --password-file /root/private-password.txt และ --yes ไฟล์รหัสผ่านต้องมี root เป็นเจ้าของและโหมด 600 อย่าใส่รหัสผ่านในคำสั่งหรือตัวแปรสภาพแวดล้อม
--yes ข้ามเฉพาะการยืนยัน กู้คืนอัปเดตที่ขัดจังหวะให้เสร็จก่อน หากมีการเปลี่ยนบัญชีพร้อมกันจะหยุดรีเซ็ต