Google Pembayaran Standar: FOP Kartu

Ringkasan

Card FOP (Metode Pembayaran) API mendukung pembayaran yang dilakukan menggunakan kartu standar. Ini dapat berupa kartu kredit dan debit. Ada metode tunggal dan alur pesan ganda yang disediakan untuk pembayaran.

Konsep penting

Simbol & Konvensi

Kata kunci "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SEHARINYA", "DIREKOMENDASIKAN", "MAY", dan "OPTIONAL" dalam dokumen ini harus ditafsirkan sebagaimana dijelaskan dalam RFC 2119.

Stempel waktu

Semua stempel waktu direpresentasikan sebagai milidetik sejak epoch Unix dalam UTC.

Contoh:

• 14 Agustus 2010 16:30:00.00 GMT = 1281803400000
• 6 November 2007 21:37:00 PM MST = 1194410220000

Jumlah

Nilai uang dalam API ini diwakili menggunakan format yang disebut "micros", sebuah standar di Google. Mikro adalah format presisi tetap yang berbasis bilangan bulat. Untuk merepresentasikan nilai uang dalam mikro, kalikan nilai mata uang standar dengan 1.000.000.

Contoh:

• USD$1,23 = 1230000 USD mikro
• USD$0,01 = 10.000 USD mikro

Idempotensi

Semua panggilan metode dalam API ini harus memiliki perilaku idempoten. Sederhananya, integrator tidak boleh mencoba memproses ulang permintaan yang sudah berhasil diproses; sebagai gantinya, respons untuk pemrosesan yang berhasil harus dilaporkan. Semua metode memiliki RequestHeader umum yang berisi requestId. requestId ini adalah kunci idempotensi untuk semua panggilan.

Untuk jawaban non-terminal (non-HTTP 200), jawaban tersebut tidak boleh diproses secara idempoten. Jadi, permintaan yang sebelumnya mendapatkan 400, ketika dipanggil untuk kedua kalinya tidak boleh secara idempoten menampilkan 400, permintaan tersebut harus dievaluasi ulang. Saat dievaluasi ulang, angka 400 mungkin akan muncul atau berhasil diproses.

Untuk mengetahui informasi selengkapnya tentang idempotensi, lihat panduan mendetail ini.

Alur pengambilan pesanan

Alur pengambilan cadangan adalah alur dua pesan dalam dana mana yang pertama kali disimpan dan kemudian ditangkap. Selama reservasi tidak ada pergerakan uang. Reservasi kemudian dapat dibatalkan atau direkam. Tujuan hasil akhir perekaman atau pembatalan ditampilkan secara asinkron ke Google melalui notifikasi.

Integrator Pembayaran menerapkan

• reserveFunds
• asynchronousCaptureFundsReservation
• asynchronousCancelFundsReservation

Google menerapkan

• captureFundsReservationResultNotification
• cancelFundsReservationResultNotification
• setAcquirerReferenceNumberForCaptureNotification

Untuk informasi selengkapnya tentang tangkapan cadangan, lihat panduan terperinci.

Alur transfer dana

Alur transfer dana adalah alur pesan tunggal di dana mana yang langsung ditangkap. Alur terdiri dari satu metode yang diterapkan oleh Integrator Pembayaran bernama Capture. Metode ini memeriksa dana yang tersedia secara sinkron dan mengambil dana jika berhasil.

Integrator Pembayaran menerapkan

• capture

Google menerapkan

• setAcquirerReferenceNumberForCaptureNotification

Untuk informasi selengkapnya tentang transfer dana, lihat panduan terperinci.

Alur pengembalian dana

Alur pengembalian dana digunakan untuk mengembalikan dana yang sebelumnya direkam melalui alur pengambilan cadangan atau alur transfer dana.

Integrator Pembayaran menerapkan

• asynchronousRefund

Google menerapkan

• refundResultNotification
• reverseRefundNotification
• setAcquirerReferenceNumberForRefundNotification

Untuk informasi selengkapnya tentang pengembalian dana, lihat panduan mendetail ini.

Alur sengketa

Alur sengketa. digunakan untuk memberi tahu Google mengenai sengketa dan penagihan balik di mana pelanggan meminta penggantian biaya. Tidak setiap panggilan menyiratkan perpindahan uang, tetapi aliran ini dapat digunakan untuk mengembalikan dana kepada pelanggan, atau untuk membatalkannya dan mengembalikannya ke Google. Alur ini dapat digunakan di selain alur pelaporan penipuan, tetapi tidak tentu saja mencakup penipuan.

Google menerapkan

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

Untuk informasi selengkapnya tentang sengketa, lihat panduan mendetail ini.

Alur pelaporan penipuan

Alur pelaporan penipuan digunakan untuk memberi tahu Google tentang potensi penipuan. Informasi ini tidak menyiratkan pergerakan uang dan hanya digunakan untuk memberi tahu Mesin Risiko Google tentang peristiwa tersebut sehingga seluruh penipuan dapat dikurangi. Hal ini dapat disertai dengan sengketa atau penagihan balik melalui alur sengketa.

Google menerapkan

• fraudNotification

Untuk informasi selengkapnya tentang pelaporan penipuan, lihat panduan terperinci.