Google Pembayaran Standar: FOP Kartu

Ringkasan

Card FOP (Metode Pembayaran) API mendukung pembayaran yang dilakukan menggunakan kartu standar. Kartu ini dapat berupa kartu kredit dan debit. Ada alur pesan tunggal dan 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.

Simpan alur pengambilan gambar

Alur pengambilan cadangan adalah alur dua pesan tempat dana pertama kali dicadangkan, lalu ditangkap. Selama reservasi, tidak ada perpindahan uang yang terjadi. Reservasi kemudian dapat dibatalkan atau direkam. Hasil akhir perekaman atau pembatalan akan ditampilkan secara asinkron ke Google melalui notifikasi.

Integrator Pembayaran menerapkan

• reserveFunds
• asynchronousCaptureFundsReservation
• asynchronousCancelFundsReservation

Google menerapkan

• captureFundsReservationResultNotification
• cancelFundsReservationResultNotification
• setAcquirerReferenceNumberForCaptureNotification

Untuk informasi selengkapnya tentang pengambilan cadangan, lihat panduan mendetail ini.

Alur transfer dana

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

Integrator Pembayaran menerapkan

• capture

Google menerapkan

• setAcquirerReferenceNumberForCaptureNotification

Untuk mengetahui informasi selengkapnya tentang transfer dana, lihat panduan mendetail ini.

Alur pengembalian dana

Arus pengembalian dana digunakan untuk mengembalikan dana yang sebelumnya ditangkap 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 jika ada sengketa dan penagihan balik yang mengharuskan pelanggan meminta penggantian biayanya. Tidak semua panggilan menyiratkan perpindahan uang, tetapi aliran ini dapat digunakan untuk mengembalikan dana ke pelanggan, atau untuk membaliknya dan mengembalikannya ke Google. Alur ini dapat digunakan sebagai tambahan untuk alur pelaporan penipuan, tetapi tidak selalu menyertakan penipuan.

Google menerapkan

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

Untuk mengetahui informasi selengkapnya mengenai sengketa, lihat panduan mendetail ini.

Alur pelaporan penipuan

Alur pelaporan penipuan adalah untuk memberi tahu Google tentang potensi penipuan. Informasi ini tidak menyiratkan pergerakan uang dan hanya digunakan untuk menginformasikan Risk Engine Google tentang peristiwa tersebut, sehingga penipuan secara keseluruhan 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 mendetail ini.