Real-Time Payment Verification untuk AI Agent: Cek Status Transaksi secara Otomatis

Real-Time Payment Verification adalah proses pemeriksaan status transaksi secara otomatis oleh AI Agent melalui integrasi dengan sistem payment gateway. Fitur ini memungkinkan AI Agent mengetahui apakah pembayaran berhasil (paid), masih menunggu (pending), gagal (failed), kedaluwarsa (expired), atau dibatalkan (cancelled) tanpa harus memeriksa transaksi secara manual.

Dalam implementasi Agentic Payments bersama DOKU, AI Agent dapat meminta informasi status transaksi melalui MCP Server yang terhubung dengan DOKU Payment API. Informasi tersebut kemudian diproses dan disampaikan kembali kepada pengguna dalam bentuk respons yang mudah dipahami. Lalu, bagaimana mekanisme Real-Time Payment Verification bekerja dan bagaimana AI Agent memeriksa status pembayaran secara otomatis?

Apa Itu Real-Time Payment Verification?

Real-time payment verification adalah proses memeriksa dan memastikan status pembayaran secara otomatis melalui sistem pembayaran yang terhubung dengan aplikasi bisnis. Sederhananya, setelah pelanggan melakukan pembayaran, sistem bisnis perlu mendapatkan jawaban atas pertanyaan: “Apakah transaksi ini benar-benar sudah berhasil?”

Jawaban tersebut idealnya berasal dari sumber pembayaran yang terotorisasi, bukan sekadar dari pernyataan pelanggan atau perubahan halaman di sisi frontend. Dalam integrasi DOKU, merchant dapat menerima pembaruan melalui HTTP notification/webhook maupun menggunakan Check Status API untuk memperoleh status transaksi. 

Konsep ini penting karena payment status verification harus terjadi di backend. Frontend dapat memberi pengalaman kepada pelanggan, tetapi keputusan bisnis seperti fulfillment sebaiknya didasarkan pada status transaksi yang telah diverifikasi.

Mengapa AI Agent Perlu Mengetahui Status Transaksi?

AI agent bekerja dengan konsep reasoning dan tool calling. Agent dapat menerima permintaan seperti “buatkan pembayaran”, memanggil payment tool, lalu melanjutkan workflow berdasarkan hasil tool tersebut.

Namun, membuat transaksi dan memastikan transaksi berhasil adalah dua hal berbeda. Misalnya, pelanggan meminta AI agent membeli tiket. Agent membuat payment request dan memberikan instruksi pembayaran. Pada tahap tersebut, transaksi mungkin masih PENDING. Agent tidak seharusnya langsung menyatakan pembelian selesai.

Dengan AI agent payment status, agent dapat mengambil status transaksi melalui tool yang tersedia. Pola ini memungkinkan AI agent melakukan workflow seperti:

1. Create payment 
2. Monitor status 
3. Verify
4. Trigger action
5. Inform customer

Dengan demikian, AI tidak hanya menjadi conversational interface, tetapi dapat menjadi bagian dari workflow pembayaran yang terhubung dengan sistem bisnis.

Baca juga: Bagaimana Cara Verifikasi Pembayaran Otomatis Tanpa Upload Bukti Transfer?

Memahami Siklus Status Pembayaran 

Status pembayaran sebaiknya dipahami sebagai sebuah lifecycle, bukan sekadar kondisi “sudah bayar” atau “belum bayar”. Pada DOKU, beberapa status transaksi yang terdokumentasi antara lain:

• PENDING: transaksi masih menunggu pembayaran.
• SUCCESS: pembayaran berhasil.
• FAILED: transaksi gagal.
• EXPIRED: batas waktu pembayaran telah terlewati.
• REFUNDED: dana transaksi telah dikembalikan.
• TIMEOUT: transaksi mengalami timeout dan membutuhkan pemeriksaan status lebih lanjut pada channel tertentu.
• REDIRECT: pada channel tertentu, transaksi masih menunggu proses verifikasi acquirer.

Status tersebut memiliki konsekuensi bisnis yang berbeda. Contohnya, SUCCESS dapat menjadi sinyal untuk melanjutkan fulfillment. Sebaliknya, PENDING berarti agent perlu menunggu, sedangkan EXPIRED dapat mengharuskan pembuatan payment request baru. Karena itu, developer sebaiknya membuat state machine yang jelas.

Cara Agent Meminta atau Menerima Status

Ada dua pola utama dalam real-time payment verification: sistem pembayaran mengirimkan status ke merchant, atau sistem merchant secara aktif meminta status.

1. Webhook

Webhook memungkinkan payment provider mengirimkan notifikasi ke endpoint merchant ketika terjadi event pembayaran. Dokumentasi DOKU menjelaskan bahwa payment notification dapat digunakan untuk menerima update secara real-time melalui API webhook. 

Setelah pelanggan menyelesaikan pembayaran, DOKU mengirimkan notification ke URL yang telah dikonfigurasi merchant. Model ini cocok untuk event-driven architecture karena sistem tidak perlu terus-menerus bertanya apakah transaksi sudah berubah.

2. Polling atau Check Status API

Pada polling, sistem merchant secara berkala meminta status transaksi kepada payment provider. DOKU menyediakan Check Status API untuk memperoleh status transaksi berdasarkan identifier seperti invoice number atau Request-Id. 

Dokumentasinya juga menetapkan kapan Check Status API dapat digunakan setelah pembayaran, bergantung pada integrasi dan channel terkait. Pendekatan ini berguna sebagai mekanisme pengecekan atau fallback ketika webhook belum diterima.

3. MCP Tool Response

Untuk AI agent, status juga dapat diperoleh melalui MCP payment status. DOKU MCP Server menyediakan transaction utility untuk mengambil detail transaksi berdasarkan invoice number, termasuk status transaksi. 

Use case AI chatbot yang dapat membuat pembayaran, memantau status melalui polling atau webhook, lalu memberi tahu pelanggan setelah pembayaran terkonfirmasi. MCP dapat menjadi lapisan tool interface agar agent dapat berinteraksi dengan kemampuan pembayaran tanpa harus memahami seluruh kompleksitas API di belakangnya.

Jenis-Jenis Status Transaksi Pembayaran: Pending, Success, Failed, Expired, dan Refunded

Agent perlu memperlakukan setiap status secara berbeda, dengan penjelasan sebagai berikut:

1. Pending berarti jangan menjalankan fulfillment yang membutuhkan pembayaran final. Agent dapat memberi tahu pelanggan bahwa pembayaran masih diproses.

2. Success merupakan status final yang menunjukkan transaksi berhasil. Setelah validasi tambahan sesuai kebutuhan bisnis, sistem dapat menjalankan fulfillment.

3. Failed berarti transaksi tidak berhasil. Sistem dapat mengarahkan customer untuk mencoba payment request baru sesuai aturan channel.

4. Expired berarti batas waktu pembayaran telah terlewati. Untuk melanjutkan transaksi, bisnis mungkin perlu membuat payment request baru.

5. Refunded memiliki arti berbeda dari failed. Transaksi sebelumnya berhasil, tetapi dana kemudian dikembalikan. Karena itu, status refund perlu diperlakukan sebagai event bisnis tersendiri.

Webhook, Polling, dan MCP Tool Response untuk Verifikasi Pembayaran 

Ketiganya tidak harus dianggap sebagai alternatif yang saling meniadakan. Webhook cocok sebagai mekanisme event-driven notification. Polling atau Check Status API dapat menjadi mekanisme verification dan fallback. MCP tool response menjadi antarmuka yang memungkinkan AI agent mengakses informasi tersebut melalui tool.

Arsitektur yang lebih kuat dapat menggunakan webhook untuk memperbarui database internal, kemudian menyediakan fungsi status tersebut kepada AI agent melalui tool. Jika event belum tersedia atau terjadi kondisi tertentu, backend dapat melakukan pengecekan status melalui API. Payment provider dan backend transaction ledger tetap menjadi source of truth.

Idempotency dan Pencegahan Konfirmasi Transaksi Ganda 

Satu hal yang sering diabaikan dalam sistem pembayaran adalah kemungkinan event diterima lebih dari sekali. Misalnya, webhook SUCCESS diterima dua kali. Jika setiap notification langsung memicu pengiriman barang, sistem dapat melakukan fulfillment ganda. Karena itu, backend perlu menerapkan idempotency.

Gunakan identifier transaksi atau request/event identifier yang sesuai untuk memastikan event yang sama tidak diproses berulang. Dokumentasi DOKU juga menggunakan Request-Id sebagai identifier unik dalam mekanisme request dan notification. Status boleh diperbarui berulang kali, tetapi efek bisnis tidak boleh dieksekusi berulang kali.

Menjalankan Action Setelah Status Pembayaran Terkonfirmasi 

Setelah status SUCCESS telah diverifikasi, barulah sistem dapat menjalankan action berikutnya. Contohnya adalah mengubah status order menjadi paid, mengaktifkan subscription, mengirim produk digital, membuat tiket, memperbarui inventory, atau memberi tahu customer. Untuk AI agent, workflow dapat dibuat seperti:

• Payment created
• Status pending 
• Payment notification/status check 
• Verified success 
• Business action 
• Customer notification

Agent sebaiknya tidak langsung menjalankan action hanya karena API pembuatan pembayaran berhasil. Payment creation success bukan berarti payment transaction success.

Security dan Access Control dalam Payment Verification 

AI payment verification juga harus memperhatikan keamanan. Credential seperti API key dan secret tidak boleh diberikan kepada customer atau dimasukkan ke prompt AI. Credential harus disimpan pada server atau secret manager dan digunakan melalui integration layer yang memiliki akses terbatas.

DOKU mendokumentasikan penggunaan credential seperti Client ID, Secret Key, dan public keys untuk autentikasi serta validasi komunikasi dalam integrasi. Pada webhook, signature juga perlu diverifikasi sebelum sistem mempercayai notification. Dokumentasi DOKU menunjukkan adanya signature pada notification dan mekanisme untuk memastikan autentisitas request.

Prinsip lainnya adalah least privilege. AI agent sebaiknya hanya mendapatkan tool yang benar-benar dibutuhkan. Agent yang hanya perlu membaca status transaksi tidak harus memiliki akses untuk melakukan refund atau membuat transaksi baru.

Monitoring dan Audit Log Transaksi 

Sistem pembayaran yang terhubung dengan AI membutuhkan observability yang baik. Simpan setidaknya informasi seperti invoice number, transaction identifier, status sebelumnya, status terbaru, timestamp, sumber event, dan action yang dijalankan.

Audit log membantu menjawab pertanyaan penting ketika terjadi dispute: kapan status berubah, dari mana informasi tersebut diterima, dan action apa yang dilakukan sistem. Untuk bisnis dengan volume transaksi tinggi, monitoring juga membantu mendeteksi pola seperti webhook failure atau perbedaan antara transaction ledger dan order database.

Baca juga: AI Agent yang Bisa Verifikasi Pembayaran Sendiri?

FAQ Real-Time Payment Verification

Apa perbedaan webhook dan polling?

Webhook mengirimkan notifikasi dari payment provider ke sistem merchant ketika event tertentu terjadi. Polling berarti merchant secara aktif meminta status transaksi melalui API.

Apakah AI agent bisa mengecek status pembayaran?

Bisa, jika AI agent diberikan akses ke tool atau API yang memiliki izin untuk mengambil informasi transaksi. DOKU MCP Server menyediakan tool untuk mengambil detail transaksi berdasarkan invoice number, termasuk statusnya.

Mengapa idempotency penting?

Idempotency mencegah satu event pembayaran yang diterima berulang kali menyebabkan action bisnis, seperti fulfillment atau pengiriman produk, dieksekusi lebih dari sekali.

Apakah status SUCCESS langsung berarti order harus diproses?

Secara umum, SUCCESS menunjukkan pembayaran berhasil, tetapi bisnis tetap perlu menerapkan aturan validasi dan fulfillment sendiri. Status transaksi dan keputusan bisnis sebaiknya dipisahkan sebagai dua layer.

DOKU untuk Mendukung Kebutuhan Pembayaran Bisnis Anda

Real-time payment verification menjadi semakin penting ketika bisnis mengembangkan checkout, API, automation, dan AI agent dalam satu customer journey. Dengan DOKU Agentic Payment, bisnis dapat menghubungkan AI agent dengan kapabilitas pembayaran DOKU, sehingga proses transaksi dapat menjadi bagian dari workflow berbasis AI.

Sebagai Power Up atau integrasi lanjutan dalam ekosistem layanan payment gateway DOKU, solusi ini ditujukan bagi merchant yang ingin mengembangkan kapabilitas pembayaran berbasis AI. Bisnis dapat memilih produk pembayaran utama sesuai kebutuhan, seperti DOKU Checkout untuk Hosted Payment Gateway, DOKU Direct API untuk Self-Hosted Payment Gateway, DOKU Plugin untuk e-commerce, hingga DOKU Payment Link dan katalog online melalui DOKU Digital Catalog tanpa integrasi teknis. Untuk menggunakan DOKU Agentic Payment, merchant juga perlu menyiapkan AI assistant atau AI agent yang kompatibel dengan MCP Server.

Sebagai pionir payment gateway sejak 2007, DOKU telah berkembang menjadi payment fintech company yang mendukung lebih dari 300.000 bisnis, dengan layanan after-sales proaktif dan customer service 24/7. Hubungi tim Sales DOKU untuk konsultasi kebutuhan DOKU Agentic Payment bagi bisnis Anda.