การเผยแพร่แอปสู่ Stripe App Marketplace

การเผยแพร่ Stripe App ของคุณขึ้นมาร์เก็ตเพลสจะทำให้ผู้ใช้ Stripe ทุกคนเข้าถึงแอปได้ คู่มือนี้ครอบคลุมข้อกำหนด ขั้นตอนการเตรียมความพร้อม และกระบวนการส่งแอปเพื่อพิจารณา

สิ่งที่ต้องมีก่อนเริ่ม

ก่อนที่คุณจะเผยแพร่แอปขึ้น Stripe App Marketplace ได้ คุณต้องมีคุณสมบัติตามข้อกำหนดเหล่านี้

• บัญชี Stripe ที่เปิดใช้งานแล้ว: บัญชีของคุณต้องไม่ถูกจำกัดให้ใช้ได้เฉพาะโหมดทดสอบ
• หนึ่งแอปต่อหนึ่งบัญชี: บัญชี Stripe แต่ละบัญชีเผยแพร่แอปสาธารณะขึ้นมาร์เก็ตเพลสได้เพียงหนึ่งแอปเท่านั้น
• ภาษาอังกฤษเท่านั้น: เนื้อหาของแอป ข้อความในหน้าจอ และข้อมูลลิสติงทั้งหมดต้องเป็นภาษาอังกฤษ
• แอปที่สมบูรณ์: แอปของคุณต้องทำงานได้ครบถ้วนและผ่านการทดสอบแล้ว

ขั้นตอนการเผยแพร่

ขั้นตอนที่ 1: อัปเดตไฟล์ manifest

กำหนดค่า distribution_type ในไฟล์ stripe-app.json ของคุณเป็น public

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

ขั้นตอนที่ 2: เตรียมแอปของคุณ

ตรวจสอบให้แน่ใจว่าแอปของคุณเป็นไปตามข้อกำหนดการตรวจสอบ ทั้งหมดก่อนส่ง

1. ทดสอบอย่างละเอียดทั้งในโหมดใช้งานจริงและโหมด sandbox
2. ตรวจสอบว่าสิทธิ์ทุกรายการจำเป็นจริงและมีคำอธิบายกำกับไว้
3. ยืนยันว่าได้ใส่การจัดการข้อผิดพลาดและสถานะกำลังโหลดไว้แล้ว
4. ตรวจสอบว่าข้อความในหน้าจอทั้งหมดเป็นภาษาอังกฤษ

ขั้นตอนที่ 3: อัปโหลดแอปของคุณ

ใช้ Stripe CLI เพื่ออัปโหลดแอปของคุณ

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

ขั้นตอนที่ 4: เขียนลิสติงของคุณ

ไปที่ Stripe Dashboard เพื่อกรอกข้อมูลลิสติงของแอปให้ครบถ้วน ทุกช่องในลิสติงเป็นข้อมูลที่จำเป็นสำหรับการส่งขึ้นมาร์เก็ตเพลส

ขั้นตอนที่ 5: ส่งเข้ารับการตรวจสอบ

หลังจากกรอกลิสติงเสร็จแล้ว ให้ส่งแอปเข้ารับการตรวจสอบผ่าน Stripe Dashboard ทีมงาน Stripe จะประเมินแอปของคุณเทียบกับข้อกำหนดด้านคุณภาพ

ขั้นตอนที่ 6: เผยแพร่

เมื่อได้รับอนุมัติแล้ว คุณสามารถเผยแพร่แอปเพื่อให้พร้อมใช้งานบนมาร์เก็ตเพลสได้

การตั้งค่า manifest สำหรับการเผยแพร่แบบสาธารณะ

ไฟล์ manifest ต้องมี distribution_type: "public" และต้องประกาศสิทธิ์ที่จำเป็นทั้งหมดพร้อมคำอธิบายวัตถุประสงค์ที่ชัดเจน

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

อัปโหลดแอปที่ตั้งค่าเรียบร้อยแล้วด้วยคำสั่ง

stripe apps upload

ข้อกำหนดของลิสติง

ลิสติงแอปของคุณต้องมีข้อมูลครบทุกช่องต่อไปนี้

แนวทางการตั้งชื่อ

• ต้องไม่ซ้ำกับแอปอื่นบนมาร์เก็ตเพลส
• ควรสื่อถึงวัตถุประสงค์ของแอปอย่างชัดเจน
• หลีกเลี่ยงคำกว้าง ๆ ที่อาจทำให้ผู้ใช้สับสน
• ตัวอย่าง: “Tajo for Brevo” (15 ตัวอักษร)

แนวทางการทำไอคอน

• ขนาด: 300x300 พิกเซลพอดี
• รูปแบบ: PNG หรือ SVG
• อย่าลบมุมเอง เพราะ Stripe จะจัดการให้โดยอัตโนมัติ
• ใช้โลโก้หรือสัญลักษณ์ที่ชัดเจนและจดจำง่าย
• ตรวจสอบว่ายังอ่านออกเมื่อแสดงในขนาดเล็ก

ส่วน About

เขียนคำอธิบายที่น่าสนใจโดยครอบคลุมประเด็นเหล่านี้

• แอปของคุณแก้ปัญหาอะไร
• ความสามารถหลักในการเชื่อมต่อ
• แอปนี้ออกแบบมาสำหรับใคร
• สิ่งที่ต้องเตรียมหรือข้อกำหนดใด ๆ

ตัวอย่าง (ข้อความลิสติงต้องเป็นภาษาอังกฤษตามข้อกำหนดของ Stripe)

Tajo for Brevo connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

ฟีเจอร์หลัก

รายการฟีเจอร์หลักแต่ละรายการประกอบด้วย

• Title: ชื่อฟีเจอร์แบบสั้น
• Description: คำอธิบายฟีเจอร์หนึ่งถึงสองประโยค
• Image: ภาพหน้าจอหรือแผนภาพ (แนะนำขนาด 1600x900 พิกเซล)

ฟีเจอร์ที่แนะนำสำหรับการเชื่อมต่อ Tajo Brevo

1. Real-time Customer Sync, ซิงค์โปรไฟล์ลูกค้าจาก Stripe ไปยัง contact ใน Brevo โดยอัตโนมัติพร้อมประวัติการซื้อทั้งหมด
2. Event-Driven Automation, เริ่มเวิร์กโฟลว์ใน Brevo จากอีเวนต์ของ Stripe เช่น การชำระเงินสำเร็จ การเปลี่ยนแปลงการสมัครสมาชิก และการคืนเงิน
3. Product Catalog Sync, รักษาแคตตาล็อกสินค้าใน Brevo ให้ตรงกับ Stripe เสมอ เพื่อใช้ทำเนื้อหาแคมเปญเฉพาะบุคคล
4. Multi-Channel Campaigns, ใช้ข้อมูลที่ซิงค์แล้วขับเคลื่อนแคมเปญอีเมล SMS และ WhatsApp แบบเจาะกลุ่มเป้าหมาย
5. Dashboard Insights, ดูตัวชี้วัด engagement ของ Brevo ได้โดยตรงในหน้าข้อมูลลูกค้าของ Stripe Dashboard

ข้อมูลด้านราคา

สื่อสารรูปแบบราคาของคุณให้ชัดเจน

• ฟรี: ไม่มีค่าใช้จ่ายในการติดตั้งหรือใช้งาน
• เสียเงิน: ระบุราคาและรอบการเรียกเก็บเงิน
• Freemium: อธิบายว่าอะไรใช้ได้ฟรีและอะไรต้องเสียเงิน
• คิดตามการใช้งาน: อธิบายระดับราคาหรือค่าใช้จ่ายต่อหน่วย

การทดสอบแอปของคุณ

ก่อนส่งแอป ให้ทดสอบอย่างละเอียด

ทดสอบในโหมด sandbox

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

รูปแบบข้อมูลรับรองสำหรับการทดสอบ

เมื่อต้องส่งข้อมูลรับรองสำหรับทดสอบให้ทีมตรวจสอบ ให้ใช้รูปแบบนี้

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

รายการตรวจสอบก่อนส่ง

ก่อนส่งแอป ให้ตรวจสอบสิ่งเหล่านี้

• แอปทำงานได้ทั้งในโหมดใช้งานจริงและโหมดทดสอบ
• สิทธิ์ทุกรายการมีคำอธิบายวัตถุประสงค์ที่ชัดเจน
• มีการจัดการสถานะข้อผิดพลาดอย่างเหมาะสม
• แสดงสถานะกำลังโหลดสำหรับการทำงานแบบ async
• ไม่มีข้อมูลทดสอบฝังอยู่ในบิลด์สำหรับใช้งานจริง
• URL ของนโยบายความเป็นส่วนตัวเข้าถึงได้และถูกต้อง
• ข้อมูลติดต่อฝ่ายสนับสนุนใช้งานได้จริง
• ภาพในลิสติงทุกภาพมีขนาดตรงตามข้อกำหนด
• คำอธิบายแอปสะท้อนความสามารถจริงอย่างถูกต้อง

หลังจากส่งแอปแล้ว

ทีมตรวจสอบของ Stripe มักตอบกลับภายใน 5 ถึง 10 วันทำการ โดยผลลัพธ์อาจเป็น

• อนุมัติ แอปของคุณให้เผยแพร่ได้
• ขอให้แก้ไข พร้อมข้อเสนอแนะที่เฉพาะเจาะจง
• ปฏิเสธ แอปหากไม่เป็นไปตามข้อกำหนด

หากมีการขอให้แก้ไข ให้ดำเนินการตามข้อเสนอแนะทั้งหมดแล้วส่งใหม่ การส่งใหม่แต่ละครั้งจะเข้าสู่รอบการตรวจสอบเต็มรูปแบบ

การอัปเดตแอปที่เผยแพร่แล้ว

วิธีอัปเดตแอปที่เผยแพร่ไปแล้ว

1. เพิ่มเลขเวอร์ชันในไฟล์ stripe-app.json
2. อัปโหลดเวอร์ชันใหม่ด้วยคำสั่ง stripe apps upload
3. ส่งการอัปเดตเข้ารับการตรวจสอบ
4. เมื่อได้รับอนุมัติ การอัปเดตจะถูกดีพลอยให้ผู้ใช้ทุกคนโดยอัตโนมัติ