ขอสิทธิ์ใช้งานล่วงหน้า

กรอกชื่อพร้อมอีเมลหรือหมายเลขโทรศัพท์ แล้วเราจะติดต่อกลับพร้อมรายละเอียดการเข้าใช้งาน Tajo

เอกสารอ้างอิงสิทธิ์การเข้าถึง

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

การจัดการสิทธิ์การเข้าถึง

การประกาศสิทธิ์

เพิ่มสิทธิ์ลงใน manifest stripe-app.json ของคุณ

{
"permissions": [
{
"permission": "customer_read",
"purpose": "Read customer profiles to sync with Brevo contacts"
},
{
"permission": "customer_write",
"purpose": "Update customer metadata with Brevo sync status"
}
]
}

การให้สิทธิ์ผ่าน CLI

ระหว่างการพัฒนา คุณให้สิทธิ์ผ่าน Stripe CLI ได้

Terminal window
# Grant a specific permission
stripe apps grant permission "customer_read" \
--purpose "Read customer profiles to sync with Brevo contacts"
# Grant multiple permissions
stripe apps grant permission "charge_read" \
--purpose "Access payment data for event tracking"
stripe apps grant permission "event_read" \
--purpose "Subscribe to real-time Stripe events"

แนวปฏิบัติที่ดีสำหรับสิทธิ์การเข้าถึง

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

Tip

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

สิทธิ์การเข้าถึงแยกตามผลิตภัณฑ์

Core

ทรัพยากรสิทธิ์คำอธิบาย
Accountaccount_readอ่านรายละเอียดและการตั้งค่าของบัญชี
Accountaccount_writeอัปเดตการตั้งค่าของบัญชี
Balancebalance_readดูยอดคงเหลือและรายการเคลื่อนไหวของบัญชี
Customercustomer_readอ่านโปรไฟล์ลูกค้า เมตาดาตา และวิธีการชำระเงิน
Customercustomer_writeสร้าง อัปเดต หรือลบระเบียนลูกค้า
Eventevent_readอ่านและสมัครรับอีเวนต์ของบัญชี
Filefile_readอ่านไฟล์ที่อัปโหลดไว้และลิงก์ไฟล์
Filefile_writeอัปโหลดไฟล์และสร้างลิงก์ไฟล์
Mandatemandate_readอ่านคำสั่งอนุมัติการชำระเงิน
Productproduct_readอ่านแคตตาล็อกสินค้าและราคา
Productproduct_writeสร้าง อัปเดต หรือลบสินค้าและราคา
Tokentoken_readอ่านข้อมูลการชำระเงินที่แปลงเป็นโทเคนแล้ว
Webhook Endpointwebhook_endpoint_readอ่านการตั้งค่า endpoint ของ Webhook
Webhook Endpointwebhook_endpoint_writeสร้าง อัปเดต หรือลบ endpoint ของ Webhook

Payments

ทรัพยากรสิทธิ์คำอธิบาย
Chargecharge_readอ่านรายการเรียกเก็บเงินและการคืนเงิน
Chargecharge_writeสร้างรายการเรียกเก็บเงิน ยืนยันการรับชำระ และคืนเงิน
Disputedispute_readอ่านข้อโต้แย้งการชำระเงินและหลักฐานประกอบ
Disputedispute_writeส่งหลักฐานและตอบกลับข้อโต้แย้ง
Payment Intentpayment_intent_readอ่านรายละเอียดและสถานะของ Payment Intent
Payment Intentpayment_intent_writeสร้าง ยืนยัน หรือยกเลิก Payment Intent
Payment Methodpayment_method_readอ่านวิธีการชำระเงินที่บันทึกไว้
Payment Methodpayment_method_writeผูกหรือยกเลิกการผูกวิธีการชำระเงินกับลูกค้า
Payoutpayout_readอ่านรายละเอียดและกำหนดการโอนเงินออก
Payoutpayout_writeสร้างหรือยกเลิกการโอนเงินออก
Refundrefund_readอ่านรายละเอียดการคืนเงิน
Refundrefund_writeสร้างหรืออัปเดตการคืนเงิน
Setup Intentsetup_intent_readอ่านรายละเอียดของ Setup Intent
Setup Intentsetup_intent_writeสร้างหรือยืนยัน Setup Intent

Billing

ทรัพยากรสิทธิ์คำอธิบาย
Couponcoupon_readอ่านคูปองส่วนลดและรหัสโปรโมชัน
Couponcoupon_writeสร้าง อัปเดต หรือลบคูปอง
Credit Notecredit_note_readอ่านใบลดหนี้
Credit Notecredit_note_writeสร้างหรือยกเลิกใบลดหนี้
Invoiceinvoice_readอ่านรายละเอียด รายการสินค้า และสถานะของใบแจ้งหนี้
Invoiceinvoice_writeสร้าง อัปเดต สรุปยอด หรือยกเลิกใบแจ้งหนี้
Invoice Iteminvoice_item_readอ่านรายการในใบแจ้งหนี้ที่รอดำเนินการ
Invoice Iteminvoice_item_writeสร้างหรือลบรายการในใบแจ้งหนี้
Planplan_readอ่านแพ็กเกจการสมัครสมาชิกและราคา
Planplan_writeสร้าง อัปเดต หรือลบแพ็กเกจ
Priceprice_readอ่านการตั้งค่าราคา
Priceprice_writeสร้างหรืออัปเดตราคา
Quotequote_readอ่านใบเสนอราคา
Quotequote_writeสร้าง สรุปยอด หรือยอมรับใบเสนอราคา
Subscriptionsubscription_readอ่านรายละเอียด กำหนดการ และสถานะของการสมัครสมาชิก
Subscriptionsubscription_writeสร้าง อัปเดต หรือยกเลิกการสมัครสมาชิก
Subscription Schedulesubscription_schedule_readอ่านกำหนดการของการสมัครสมาชิก
Subscription Schedulesubscription_schedule_writeสร้าง อัปเดต หรือปล่อยกำหนดการของการสมัครสมาชิก
Usage Recordusage_record_readอ่านระเบียนการใช้งานสำหรับการเรียกเก็บตามปริมาณ
Usage Recordusage_record_writeสร้างระเบียนการใช้งานสำหรับการเรียกเก็บตามปริมาณ

Checkout

ทรัพยากรสิทธิ์คำอธิบาย
Checkout Sessioncheckout_session_readอ่านรายละเอียดและรายการสินค้าของ Checkout Session
Checkout Sessioncheckout_session_writeสร้างหรือทำให้ Checkout Session หมดอายุ
Payment Linkpayment_link_readอ่านการตั้งค่าของ Payment Link
Payment Linkpayment_link_writeสร้างหรืออัปเดต Payment Link

Connect

ทรัพยากรสิทธิ์คำอธิบาย
Application Feeapplication_fee_readอ่านรายละเอียดค่าธรรมเนียมของแอปพลิเคชัน
Connected Accountconnected_account_readอ่านรายละเอียดของบัญชีที่เชื่อมต่อไว้
Connected Accountconnected_account_writeสร้างหรืออัปเดตบัญชีที่เชื่อมต่อไว้
Transfertransfer_readอ่านรายละเอียดการโอนเงินระหว่างบัญชี
Transfertransfer_writeสร้างรายการโอนเงินไปยังบัญชีที่เชื่อมต่อไว้
Top-uptopup_readอ่านรายละเอียดการเติมเงิน
Top-uptopup_writeสร้างรายการเติมเงินเข้ายอดคงเหลือของ Stripe

Issuing

ทรัพยากรสิทธิ์คำอธิบาย
Issuing Cardissuing_card_readอ่านรายละเอียดของบัตรที่ออกให้
Issuing Cardissuing_card_writeสร้าง อัปเดต หรือปิดใช้งานบัตรที่ออกให้
Issuing Cardholderissuing_cardholder_readอ่านข้อมูลของผู้ถือบัตร
Issuing Cardholderissuing_cardholder_writeสร้างหรืออัปเดตผู้ถือบัตร
Issuing Transactionissuing_transaction_readอ่านรายละเอียดธุรกรรมของบัตร
Issuing Authorizationissuing_authorization_readอ่านคำขออนุมัติการใช้บัตร
Issuing Authorizationissuing_authorization_writeอนุมัติหรือปฏิเสธคำขออนุมัติการใช้บัตร
Issuing Disputeissuing_dispute_readอ่านข้อโต้แย้งของบัตรที่ออกให้
Issuing Disputeissuing_dispute_writeสร้างหรือยื่นข้อโต้แย้งของบัตรที่ออกให้

Reporting

ทรัพยากรสิทธิ์คำอธิบาย
Report Runreport_run_readอ่านผลลัพธ์ของการประมวลผลรายงาน
Report Runreport_run_writeสร้างการประมวลผลรายงานใหม่
Report Typereport_type_readอ่านประเภทรายงานที่ใช้ได้

Tax

ทรัพยากรสิทธิ์คำอธิบาย
Tax Calculationtax_calculation_readอ่านผลการคำนวณภาษี
Tax Calculationtax_calculation_writeสร้างการคำนวณภาษี
Tax Ratetax_rate_readอ่านการตั้งค่าอัตราภาษี
Tax Ratetax_rate_writeสร้างหรืออัปเดตอัตราภาษี
Tax Registrationtax_registration_readอ่านรายละเอียดการจดทะเบียนภาษี

Terminal

ทรัพยากรสิทธิ์คำอธิบาย
Terminal Readerterminal_reader_readอ่านรายละเอียดของเครื่องอ่านบัตร
Terminal Readerterminal_reader_writeลงทะเบียนหรืออัปเดตเครื่องอ่านบัตร
Terminal Locationterminal_location_readอ่านรายละเอียดสถานที่ตั้งของเครื่องรับชำระ
Terminal Locationterminal_location_writeสร้างหรืออัปเดตสถานที่ตั้งของเครื่องรับชำระ

Secret Store

ทรัพยากรสิทธิ์คำอธิบาย
Secretsecret_readอ่านค่าลับจาก Secret Store
Secretsecret_writeสร้าง อัปเดต หรือลบค่าลับ

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

สำหรับแอปเชื่อมต่อ Tajo กับ Brevo นี่คือสิทธิ์ที่แนะนำ

{
"permissions": [
{
"permission": "customer_read",
"purpose": "Sync customer profiles and contact information to Brevo"
},
{
"permission": "customer_write",
"purpose": "Store Brevo contact ID and sync status on customer metadata"
},
{
"permission": "charge_read",
"purpose": "Track purchase events and revenue data for Brevo analytics"
},
{
"permission": "product_read",
"purpose": "Sync product catalog to Brevo for personalized email campaigns"
},
{
"permission": "event_read",
"purpose": "Listen to real-time events to trigger Brevo automation workflows"
},
{
"permission": "invoice_read",
"purpose": "Track invoice events for transactional emails via Brevo"
},
{
"permission": "subscription_read",
"purpose": "Monitor subscription lifecycle for Brevo retention campaigns"
},
{
"permission": "secret_write",
"purpose": "Securely store Brevo API credentials in Stripe Secret Store"
},
{
"permission": "secret_read",
"purpose": "Retrieve stored Brevo API credentials for data sync operations"
},
{
"permission": "webhook_endpoint_write",
"purpose": "Register webhook endpoints for real-time event delivery to Tajo"
}
]
}

ขอบเขตของสิทธิ์การเข้าถึง

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

ขอบเขตคำอธิบาย
บัญชีสิทธิ์มีผลกับข้อมูลของบัญชีที่ติดตั้งแอปเท่านั้น
บัญชีที่เชื่อมต่อสำหรับแพลตฟอร์มที่ใช้ Connect สิทธิ์สามารถขยายไปยังบัญชีที่เชื่อมต่อไว้ได้

Caution

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

ขอสิทธิ์ใช้งานล่วงหน้า

กรอกชื่อพร้อมอีเมลหรือหมายเลขโทรศัพท์ แล้วเราจะติดต่อกลับพร้อมรายละเอียดการเข้าใช้งาน Tajo

ตรวจจับอัตโนมัติ
ผู้ช่วย AI

สวัสดี! ถามฉันเกี่ยวกับเอกสารได้เลย