Lewati ke konten utama

Tawarkan penagihan tertaut di platform Anda

Artikel ini menjelaskan cara menawarkan penagihan tertaut, yang memungkinkan pelanggan Anda menghubungkan organisasi Claude Console mereka sendiri ke aplikasi Anda. Kami menagih mereka secara langsung, dan Anda tidak pernah menyimpan kunci API mereka.

Penagihan tertaut sedang dalam versi beta.

Cara kerja penagihan tertaut

Pelanggan menghubungkan organisasi Claude Console mereka ke platform Anda menggunakan OAuth alih-alih menempel kunci API. Platform Anda menyimpan ID koneksi, bukan kunci. Anda menjalankan Claude untuk pelanggan, dan kami menagih pelanggan secara langsung.

Apa yang dicakup penagihan tertaut

Penagihan tertaut mencakup endpoint /v1/messages dan /v1/chat/completions. Anda memilih siapa yang membayar setiap permintaan: pelanggan atau Anda.

Message Batches API dan Claude Managed Agents belum dicakup.

Permintaan yang dibayar pelanggan tidak dapat menggunakan eksekusi kode yang dapat ditagih. API mengembalikan kesalahan 400, jadi kirim permintaan tersebut sebagai yang dibayar platform.

Jika hanya beberapa fitur yang menagih pelanggan, beri tahu pelanggan fitur mana. Jangan katakan semua penggunaan Claude ditagih ke organisasi mereka kecuali memang demikian.

Penagihan tertaut hanya berfungsi untuk pelanggan yang organisasi Claude Console mereka ditagih secara langsung oleh Anthropic.

Berikut ini tidak dapat ditautkan:

  • Pelanggan yang mendapatkan Claude melalui penyedia cloud, seperti Bedrock, Vertex AI, atau Foundry, tidak dapat menautkan

  • Paket langganan Claude (Pro, Max, Ultra, Team, dan Enterprise) tidak dapat ditautkan

  • Organisasi Claude Console yang membayar melalui marketplace AWS, Google Cloud, atau Azure tidak dapat menggunakan penagihan tertaut

Permintaan berjalan di organisasi platform Anda, bukan milik pelanggan. Hanya penagihan yang pergi ke pelanggan. Pengaturan di organisasi pelanggan, seperti daftar IP yang diizinkan, kunci enkripsi, dan retensi data, tidak berlaku, dan konten ditangani berdasarkan perjanjian organisasi Anda dengan Anthropic.

Semua pelanggan tertaut Anda berbagi batas laju, akses model, dan tingkat layanan organisasi Anda.

Pindahkan pelanggan dari kunci API

Anda dapat terus menawarkan kunci API pelanggan bersama penagihan tertaut dan memindahkan pelanggan dengan kecepatan Anda sendiri.

Untuk memindahkan pelanggan:

  1. Terus gunakan kunci API pelanggan sampai Anda menyimpan ID koneksi mereka.

  2. Tandai permintaan pelanggan sebagai yang dibayar pelanggan.

  3. Hapus kunci API yang disimpan dan beri tahu pelanggan bahwa Anda telah melakukannya.

Siapkan penagihan tertaut

Untuk menyiapkan penagihan tertaut:

  1. Buat aplikasi OAuth di Claude Console.

  2. Di bawah Apa yang dapat dilakukan aplikasi, pilih “Tagih dan tautkan ke organisasi.”

  3. Terima Syarat Penagihan Tertaut saat diminta.

  4. Di tab Autentikasi klien aplikasi, siapkan autentikasi klien, akun layanan operator, dan ruang kerja default.

  5. Tambahkan tombol ke aplikasi Anda yang memulai penautuan, seperti “Tautkan organisasi Claude Anda.” Gunakan sampel branding kami.

  6. Buat satu profil pengguna untuk setiap organisasi pelanggan yang akan membayar. Setiap aplikasi memungkinkan satu profil per organisasi pelanggan, dan satu organisasi pelanggan per profil.

  7. Pada setiap permintaan yang harus dibayar pelanggan, kirim ID profil pelanggan, header beta penagihan, dan billing_policy dengan bill_to diatur ke user_profile.

  8. Publikasikan aplikasi saat Anda siap untuk pelanggan.

Aplikasi baru dimulai dalam pengujian. Hanya pengguna uji yang Anda daftarkan (hingga 10) yang dapat menautkannya, masing-masing dengan batas bulanan $50 atau kurang. Kecuali organisasi Anda memiliki penagihan yang difakturkan, Anda memverifikasi domain aplikasi, dan Anthropic meninjau aplikasi sebelum aktif.

Aturan penautuan

  • Jika organisasi pelanggan sudah tertaut ke aplikasi Anda melalui profil lain, penautuan ditolak.

  • Profil yang sudah tertaut ke aplikasi Anda tidak dapat ditautkan ke organisasi kedua.

  • Untuk memindahkan tautan, lepas tautan terlebih dahulu, lalu tautkan lagi.

  • Anda tidak dapat menautkan aplikasi Anda ke organisasi Claude Console yang memilikinya. Untuk menguji penagihan tertaut seperti yang dilakukan pelanggan, gunakan organisasi Claude Console kedua yang dapat menautkan.

  • Gunakan ID profil pengguna yang sama untuk memulai tautan dan membuat permintaan pelanggan tersebut.

  • Permintaan yang dibayar pelanggan yang menyebutkan profil tanpa tautan ditolak dengan kesalahan 403, bahkan ketika Console pelanggan menunjukkan platform Anda sebagai Tertaut.

  • Permintaan yang dibayar pelanggan yang menyebutkan profil pelanggan lain Anda ditagih ke pelanggan tersebut.

Untuk membayar penggunaan Anda sendiri, kirim permintaan tanpa billing_policy.

Untuk langkah lengkap dan nilai header, lihat Dokumentasi Platform Claude.

Apa yang dilihat pelanggan saat mereka menautkan

Saat pelanggan menautkan organisasi mereka:

  1. Mereka mengklik tombol yang Anda tambahkan ke aplikasi Anda, seperti “Tautkan organisasi Claude Anda.”

  2. Mereka masuk ke Claude. Jika email mereka milik lebih dari satu organisasi, mereka memilih satu. Jika mereka belum memiliki akun Claude atau organisasi Claude Console, mereka dapat membuatnya di sini, menambahkan kredit, dan kemudian kembali untuk menyelesaikan penautuan.

  3. Mereka membaca cara kerja penagihan, lalu menetapkan batas pengeluaran bulanan untuk aplikasi Anda atau melanjutkan tanpa batas. Jika aplikasi Anda masih dalam pengujian, mereka harus menetapkan batas $50 atau kurang.

  4. Mereka melihat halaman persetujuan dengan nama aplikasi Anda dan apa yang Anda minta. Ini mengatakan penggunaan ditagih berdasarkan syarat penagihan organisasi yang ada.

  5. Mereka menyetujui dan kembali ke aplikasi Anda.

Hanya pengguna dengan peran Admin atau Billing yang dapat menyetujui. Pelajari lebih lanjut tentang peran dan izin Claude Console. Jika orang lain mencoba menyetujui, kami mengirimnya kembali ke aplikasi Anda dengan kesalahan akses ditolak. Rencanakan penyerahan, seperti cara meneruskan permintaan ke administrator.

Satu persetujuan mencakup seluruh organisasi. Tautan milik organisasi, jadi tetap aktif jika penyetuju pergi. Setiap organisasi dapat memiliki satu tautan per aplikasi.

Setelah persetujuan, anggota Admin dan Billing pelanggan biasanya menerima email yang mengonfirmasi tautan, dan yang lain jika mereka melepas tautan.

Cara pelanggan mengelola tautan

Pelanggan mengelola setiap tautan di halaman Platform tertaut di Claude Console. Mereka dapat menetapkan batas pengeluaran bulanan untuk platform Anda dan melepas tautan kapan saja. Tautkan ke halaman ini dari aplikasi Anda.

Anda juga dapat melepas tautan pelanggan. Admin di organisasi Anda melakukan ini di halaman Profil pengguna. Pelanggan tidak menerima email saat Anda melepas tautan mereka di Console, jadi beri tahu mereka sendiri. Anda juga dapat melepas tautan pelanggan dari backend Anda, dan Anthropic biasanya mengirim email kepada mereka saat Anda melakukannya.

Anda juga dapat membuat, membuat daftar, dan memperbarui profil pelanggan Anda dengan API Profil Pengguna.

Kelola pelanggan yang tidak tertaut

Anthropic tidak mengirim notifikasi ke aplikasi Anda saat pelanggan melepas tautan. Anda mengetahuinya saat permintaan yang dibayar pelanggan untuk pelanggan tersebut ditolak dengan kesalahan 403, atau dari Status tautan di halaman Profil pengguna Anda di Console. Kesalahan 403 juga dapat berarti pelanggan tidak dapat ditagih karena alasan lain.

Status Tertaut hanya mengatakan bahwa tautan ada. Permintaan masih dapat ditolak, misalnya, ketika pelanggan kehabisan kredit atau telah mencapai batas pengeluaran.

Melepas tautan biasanya menghentikan panggilan baru dalam sekitar 10 detik. Panggilan yang sudah berjalan selesai dan ditagih ke pelanggan. Tampilkan pesan yang jelas kepada pelanggan dan cara untuk menautkan lagi.

Kelola kesalahan penagihan

Jika pelanggan tidak dapat ditagih, kami menolak permintaan. Kami tidak menagih Anda untuk permintaan tersebut.

  • Jika pelanggan telah mencapai batas pengeluarannya atau Anthropic saat ini tidak dapat menagihnya (misalnya, karena kehabisan kredit atau ditangguhkan), Anda mendapatkan kesalahan 402.

  • Jika Anthropic tidak dapat menagih pelanggan karena alasan lain, Anda mendapatkan kesalahan 403.

  • Jika Anthropic tidak dapat mengonfirmasi sekarang apakah pelanggan dapat ditagih, Anda mungkin mendapatkan kesalahan 503. Coba lagi dengan backoff, dan jangan tampilkan kesalahan kepada pelanggan.

Kesalahan 402 berarti pelanggan harus bertindak. Minta mereka untuk memeriksa batas dan penagihan mereka di Claude Console.

Anda memutuskan apa yang terjadi selanjutnya. Anda dapat menjeda fitur sampai pelanggan bertindak, atau Anda dapat menutup penggunaan sendiri dengan mengirim ulang permintaan sebagai yang dibayar platform. Jika Anda menutupnya, beri tahu pelanggan berapa lama.

Pantau penggunaan dan pengeluaran

Anda melihat penggunaan setiap pelanggan dan biayanya untuk Anda. Anda tidak pernah melihat apa yang sebenarnya dibayar pelanggan.

Anda dapat memantau penggunaan setiap pelanggan dengan dua cara:

  • Di Claude Console: Pilih pelanggan di halaman Profil pengguna untuk melihat penggunaannya. Pengeluaran Anda hanya apa yang Anda bayarkan atas nama pelanggan.

  • Dengan API: Kelompokkan hasil berdasarkan user_profile_id di API Analitik Penggunaan dan Biaya, yang sedang dalam versi beta. Endpoint penggunaan mengembalikan token. Di endpoint biaya, amount adalah biaya Anda sebelum kredit, dan 0 untuk permintaan yang dibayar pelanggan Anda. list_amount adalah biaya dengan harga daftar, siapa pun yang membayar.

Kedua tampilan mencakup setiap permintaan untuk pelanggan, siapa pun yang membayar. Simpan catatan Anda sendiri tentang permintaan mana yang dibayar pelanggan. Data API biasanya menyegarkan dalam empat jam dan dapat memakan waktu hingga 24 jam.

Pertanyaan yang sering diajukan

Dapatkah pelanggan dengan persyaratan HIPAA, FERPA, atau CMEK menautkan?

Tidak selama versi beta. Permintaan tertaut berjalan di organisasi Anda, jadi perjanjian mitra bisnis pelanggan (BAA), kunci enkripsi, dan pengaturan retensi, termasuk retensi data nol, tidak berlaku. Jangan tautkan pelanggan yang memerlukan cakupan HIPAA, FERPA, atau CMEK.

Kredit mana yang dapat membayar penggunaan tertaut?

Penggunaan tertaut ditagih ke saldo prabayar atau faktur pelanggan. Beberapa kredit promosi tidak dapat digunakan.

Apa yang dapat membayar

  • Kredit yang dibeli pelanggan (saldo prabayarnya)

  • Faktur pelanggan, jika ditagih bulanan

  • Koreksi penagihan dari Anthropic

  • Kredit yang ditulis ke dalam perjanjian pelanggan

Apa yang tidak dapat membayar

Jika tidak ada yang dapat membayar di akun pelanggan, permintaannya mungkin ditolak. Setelah pelanggan menambahkan dana, pembelian dapat memakan waktu untuk diterapkan. Kami dapat memperbarui daftar ini saat program kredit kami berubah.

Apakah pertanyaan Anda terjawab?