Akun

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

Alat untuk bekerja dengan akun terletak di subbagian "Akun" dalam bagian "Pembayaran". Akun pembayaran yang sudah dibuat dapat ditemukan dalam daftar umum. Di bawah ini adalah formulir untuk membuat akun pembayaran baru.

Jenis akun pembayaran.

Saat ini, sistem memiliki beberapa jenis akun pembayaran yang dapat dipilih.

Stripe

Platform OneEntry mendukung integrasi dengan sistem pembayaran Stripe. Pilih jenis ini jika Anda ingin menghubungkan sistem pembayaran Stripe ke proyek Anda. Lebih lanjut tentang cara menghubungkan Stripe ke Platform OneEntry dapat dilihat di sini.

Midtrans

Platform OneEntry mendukung integrasi dengan sistem pembayaran Indonesia Midtrans. Lebih lanjut tentang cara menghubungkan Midtrans dapat dilihat di sini.

Xendit

Platform OneEntry mendukung integrasi dengan sistem pembayaran Xendit. Lebih lanjut tentang cara menghubungkan Xendit dapat dilihat di sini.

Kustom

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

Membuat akun pembayaran

Dalam formulir pembuatan akun pembayaran, silakan isi:

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

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

Mengubah akun pembayaran

Pilih dari daftar akun pembayaran yang ingin Anda ubah dan tekan ikon perubahan .

Dalam mode pengeditan, Anda dapat mengubah:

• Nama
• Jenis
• Token

Perubahan akan disimpan secara otomatis.

---

Parameter kustom untuk API pembayaran

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

Parameter ini dikirim dalam bentuk pasangan "kunci-nilai" saat menginisialisasi sesi pembayaran. Misalnya, dalam API Pesanan PayPal, sering kali diperlukan bidang seperti purchase_units, intent, application_context.return_url, atau payer.email_address, sedangkan Stripe menggunakan parameter lain, seperti mode, line_items, dan lain-lain.

Cara kerjanya

Selain bidang dasar (Nama, Jenis, Token), Anda akan melihat tabel "Parameter Kustom untuk API Pembayaran". Tabel ini merupakan agregasi set atribut dari modul Pengaturan, dan memungkinkan Anda untuk menetapkan kesesuaian antara:

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

Untuk menetapkan nilai - Anda perlu membuka pengeditan set, dengan menekan tombol . Selanjutnya, pilih atribut yang diperlukan dari set yang telah disiapkan, dan masukkan nilai yang diperlukan, sesuai dengan jenis atribut.

⚠️ Penting: set atribut dan isinya diatur secara terpisah dan dapat mencakup bidang dari berbagai jenis: string, angka, nilai boolean, JSON, dan lain-lain.

Contoh penggunaan dengan PayPal Misalkan, Anda ingin mengirim detail pesanan ke PayPal melalui bidang purchase_units. Anda membuat set atribut bernama "PayPal Purchase Unit", menambahkan atribut items dengan tipe JSON, yang berisi struktur sebagai berikut:

    {
      "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": "T-Shirt",
          "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 "PayPal Purchase Unit" Saat membuat pesanan, sistem secara otomatis akan memasukkan nilai aktual dari atribut ini ke dalam tubuh permintaan ke API PayPal.

Parameter lain yang sering digunakan di PayPal:

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 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 itu, pada akun yang dipilih, tekan ikon "mata" .

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

Menghapus akun pembayaran

Pilih dari daftar akun pembayaran yang ingin Anda hapus dan tekan ikon penghapusan .

Konfirmasikan tindakan dalam dialog. Setelah itu, akun pembayaran akan dihapus dan hilang dari daftar umum.