Lewati ke konten utama

Akun

Akun pembayaran adalah cara untuk menerima pembayaran saat melakukan pemesanan. Anda dapat membuat beberapa akun untuk berbagai jenis pembayaran, seperti menghubungkan sistem pembayaran atau menambahkan pembayaran tunai.

Alat untuk mengelola akun terletak di subbagian "Akun" di bawah "Pembayaran." Akun pembayaran yang ada terdaftar dalam daftar umum. Di bawah ini adalah formulir untuk membuat akun pembayaran baru.

Jenis Akun Pembayaran​

Saat ini, ada dua jenis akun pembayaran yang tersedia dalam sistem.

Stripe​

Platform OneEntry mendukung integrasi dengan sistem pembayaran Stripe. Pilih jenis ini jika Anda ingin menghubungkan sistem pembayaran Stripe ke proyek Anda. Detail lebih lanjut tentang menghubungkan Stripe ke Platform OneEntry dapat ditemukan di sini.

Kustom​

Jika Anda ingin menggunakan sistem pembayaran yang berbeda atau menerima pembayaran tunai, gunakan jenis akun pembayaran ini.

Membuat Akun Pembayaran​

Dalam formulir pembuatan akun pembayaran, tentukan:

  • Nama - String yang tidak unik
  • Tipe - Nilai dari daftar dropdown.
  • Token - String yang unik.

Setelah mengisi formulir, klik tombol "Tambah". Jika semua kolom diisi dengan benar, akun pembayaran akan dibuat dan ditambahkan ke daftar umum.

Mengedit Akun Pembayaran​

Pilih akun pembayaran yang ingin Anda edit dari daftar dan klik ikon edit Edit.

Dalam mode edit, Anda dapat mengubah:

  • Nama
  • Tipe
  • Token

Perubahan akan disimpan secara otomatis.

Parameter Kustom untuk API Pembayaran​

Untuk integrasi yang fleksibel dengan berbagai sistem pembayaran (seperti PayPal, Stripe, dan lainnya), Anda dapat menambahkan parameter kustom yang spesifik untuk API tertentu ke akun pembayaran.

Parameter ini diteruskan sebagai pasangan kunci-nilai saat menginisialisasi sesi pembayaran. Misalnya, API Pesanan PayPal sering memerlukan bidang seperti purchase_units, intent, application_context.return_url, atau payer.email_address, sementara Stripe menggunakan parameter yang berbeda, seperti mode, line_items, dll.

Cara Kerjanya​

Selain bidang dasar (Nama, Tipe, Token), Anda akan melihat tabel berjudul "Parameter Kustom untuk API Pembayaran." Tabel ini mengumpulkan set atribut dari modul Pengaturan dan memungkinkan Anda untuk menetapkan korespondensi antara:

  • Token (Nama parameter dalam API) (misalnya, purchase_units untuk PayPal atau line_items untuk Stripe)
  • Nilai, yang akan diganti saat membuat pembayaran

Untuk menetapkan nilai, Anda perlu membuka pengeditan set dengan mengklik tombol Edit. Kemudian pilih atribut yang diperlukan dari set yang telah dikonfigurasi sebelumnya dan masukkan nilai yang diperlukan sesuai dengan tipe atribut.

⚠️ Penting: Set atribut dan isinya dikonfigurasi secara terpisah dan dapat mencakup bidang dari berbagai tipe: string, angka, boolean, JSON, dll.

Contoh Penggunaan dengan PayPal Misalkan Anda ingin meneruskan detail pesanan ke PayPal melalui bidang purchase_units. Anda membuat set atribut bernama "Unit Pembelian PayPal," menambahkan atribut items dari tipe JSON, yang berisi struktur seperti:

    {
      "invoice_id": "90210",
      "amount": {
        "currency_code": "USD",
        "value": "230.00",
        "breakdown": {
          "item_total": {
            "currency_code": "USD",
            "value": "220.00"
          },
          "shipping": {
            "currency_code": "USD",
            "value": "10.00"
          }
        }
      },
      "items": [
        {
          "name": "Kaos",
          "description": "Kaos Super Fresh",
          "unit_amount": {
            "currency_code": "USD",
            "value": "20.00"
          },
          "quantity": "1",
          "category": "BARANG_FISIK",
          "sku": "sku01",
          "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-1",
          "upc": {
            "type": "UPC-A",
            "code": "123456789012"
          }
        },
        {
          "name": "Sepatu",
          "description": "Lari, Ukuran 10.5",
          "sku": "sku02",
          "unit_amount": {
            "currency_code": "USD",
            "value": "100.00"
          },
          "quantity": "2",
          "category": "BARANG_FISIK",
          "image_url": "https://example.com/static/images/items/1/shoes_running.jpg",
          "url": "https://example.com/url-to-the-item-being-purchased-2",
          "upc": {
            "type": "UPC-A",
            "code": "987654321012"
          }
        }
      ]
}

Kemudian, dalam pengaturan akun pembayaran, Anda menghubungkan:

Kunci: purchase_units Nilai: atribut items dari set "Unit Pembelian PayPal" Saat membuat pesanan, sistem akan secara otomatis mengganti nilai saat ini dari atribut ini ke dalam tubuh permintaan ke API PayPal.

Parameter PayPal lain yang umum digunakan:

intent — misalnya, "CAPTURE" atau "AUTHORIZE" application_context.return_url — URL untuk kembali setelah pembayaran berhasil application_context.cancel_url — URL untuk membatalkan pembayaran

Mekanisme ini memungkinkan Anda untuk menyesuaikan integrasi pembayaran dengan persyaratan spesifik dari API eksternal tanpa mengubah kode platform.

Menyembunyikan Akun Pembayaran​

Jika Anda tidak ingin lagi menggunakan akun pembayaran dan tidak dapat menghapusnya karena sudah digunakan dalam proyek, Anda dapat menyembunyikannya.

Untuk melakukan ini, klik ikon "mata" Edit pada akun yang dipilih.

Akun pembayaran yang disembunyikan tidak akan ditawarkan oleh sistem untuk dipilih saat mengatur penyimpanan pesanan.

Menghapus Akun Pembayaran​

Pilih akun pembayaran yang ingin Anda hapus dari daftar dan klik ikon hapus Edit.

Konfirmasi tindakan dalam kotak dialog. Setelah itu, akun pembayaran akan dihapus dan akan menghilang dari daftar umum.