API escrow untuk marketplace

API pembayaran untuk marketplace di Indonesia. Pembeli dan penjual Anda tetap di situs Anda, sementara RekberPay menahan dana, menjalankan checkout, memutuskan sengketa, dan membayar penjual.

  • Sandbox sejak hari pertama

    Platform aktif untuk setiap workspace Enterprise. Langsung bangun integrasi dengan uang uji dan key rpe_test_. Tidak ada yang perlu diajukan.

  • Live setelah verifikasi bisnis

    Setelah KYB Anda disetujui dan RekberPay menyetujui IP allowlist di key live Anda, pesanan sungguhan bisa berjalan. Lihat tahapannya

rekberpay.com/checkout/p/…
Fujifilm X-T30 body, bekasPesanan ORD-55012 di marketplace Anda
  • Body kameraRp 4.500.000
  • Biaya RekberPayRp 90.000
  • Biaya metode pembayaranDitampilkan per metode
  • Total bayarRp 4.590.000 + biaya metode

RekberPay menahan dana sampai pesanan dicairkan. Link ini berlaku 30 menit.

Saldo penjualseller-2001
Rp 4.500.000
BCA ••7890Budi Santoso
Nama cocok
  • milestone.paid
  • milestone.shipped
  • milestone.released
  • withdrawal.settled

Contoh pesanan dari panduan sandbox kami. Nama dan nominalnya data uji.

Contoh penggunaan escrow marketplace

Di mana pun satu pengguna Anda membayar pengguna lain untuk barang atau jasa, dan dananya sebaiknya menunggu sampai pembeli puas.

  • Marketplace barang

    Pembeli membayar di checkout, penjual mengirim barang, dan Anda melaporkan nomor resinya. Dana cair saat pembeli mengonfirmasi, atau otomatis saat waktunya habis.

    Cair otomatis
    72 jam setelah pengiriman dengan resi, 36 jam tanpa resi
  • Jasa dan pekerjaan bertahap

    Satu pesanan bisa berisi beberapa milestone. Masing-masing dibayar, dikirim, dan dicairkan sendiri, jadi pekerjaan panjang tidak menahan seluruh nominal.

    Milestone
    Satu atau lebih per pesanan
  • Platform yang menjaga pengguna tetap di rumah

    Pengguna Anda tidak perlu daftar ke RekberPay dulu. Setiap orang tetap pengguna RekberPay sungguhan yang bisa mengklaim akunnya nanti, dan ratingnya dihitung di profil publik mereka.

    Identitas
    partner_user_ref milik Anda sendiri
  • Membayar pemasok Anda sendiri?

    Itu bukan pesanan marketplace. Pakai Rekber B2B untuk transaksi milestone dengan persetujuan, di workspace yang sama.

    Lihat Rekber B2B per milestone

Alur dana di escrow marketplace

Dari checkout sampai rekening bank penjual, setiap langkah adalah panggilan yang Anda buat atau webhook bertanda tangan yang Anda terima.

  1. 01

    Checkout

    Buat link checkout untuk milestone dan arahkan pembeli ke sana. Link berlaku 30 menit.

    Pembeli membayarNominal, bagian biayanya, dan biaya metode
    POST …/checkout
  2. 02

    Escrow

    RekberPay mengonfirmasi pembayaran dan menahannya. Minta penjual mengirim barang hanya setelah event ini.

    Ditahan RekberPayBukan oleh Anda, bukan oleh penjual
    milestone.paid
  3. 03

    Pencairan

    Laporkan pengiriman. Pembeli mengonfirmasi, Anda mengonfirmasi dan dana langsung cair (atau setelah jeda yang dipasang RekberPay), atau waktunya habis.

    DicairkanKe saldo penjual
    milestone.released
  4. 04

    Saldo

    Saldo mitra penjual bertambah sebesar nominal dikurangi bagian biaya penjual. Tampilkan di aplikasi Anda.

    Saldo penjualDi RekberPay, per pengguna
    GET /users/:ref/balance
  5. 05

    Penarikan

    Bayarkan ke rekening bank yang nama pemiliknya sama dengan penjual, setelah masa tunggu 24 jam.

    Bank penjualSetelah dipotong biaya penarikan
    withdrawal.settled

Sengketa

Anda atau pembeli bisa menghentikan pesanan kapan saja setelah pembayaran. Tim mediasi RekberPay lalu mencairkan, mengembalikan dana, membagi, atau melanjutkannya. dispute.opened

Rating

Beri rating pesanan yang selesai atas nama pembeli atau penjual. Rating disembunyikan sampai kedua pihak memberi rating atau 3 hari berlalu, lalu dihitung di profil RekberPay mereka. rating.published

Endpoint API escrow

Setiap panggilan butuh read, ditambah write untuk perubahan dan scope yang tertera di tiap grup. Setiap penulisan memakai Idempotency-Key.

Semua path berada di bawah https://api.rekberpay.com/v1/enterprise/platform

Pengguna users

  • POST/usersBuat pembeli atau penjual, atau hubungkan orang yang sudah punya akun
  • GET/users/:refStatus tautan, klaim, dan KYC, serta batasnya
  • PATCH/users/:refUbah nama, nomor telepon, atau email pengguna yang belum mengklaim akun
  • DEL/users/:refLepaskan tautan pengguna
  • POST/users/:ref/claim-linkIzinkan pengguna mengambil alih akunnya

Pesanan dan checkout orders

  • POST/dealsBuat pesanan dengan satu milestone atau lebih
  • GET/deals/:idCek satu pesanan, misalnya untuk melihat sudah dibayar
  • GET/dealsDaftar pesanan per pengguna atau status
  • POST/deals/:id/cancelBatalkan pesanan sebelum dibayar
  • POST/deals/:id/milestones/:mid/checkoutAmbil link checkout pembeli

Pengiriman, pencairan, dan sengketa orders

  • POST/deals/:id/milestones/:mid/shipPenjual sudah mengirim; hitungan cair otomatis dimulai
  • POST/deals/:id/milestones/:mid/extendBeri pembeli waktu tambahan
  • POST/deals/:id/milestones/:mid/confirmKonfirmasi atas nama pembeli; langsung cair, atau setelah jeda sampai 72 jam. Butuh orders:confirm, mati secara bawaan
  • POST/deals/:id/milestones/:mid/disputeLaporkan masalah pada pesanan
  • POST/deals/:id/milestones/:mid/dispute/evidenceTambahkan bukti ke sengketa

Saldo dan penarikan balance:read, withdraw

  • GET/users/:ref/balanceTampilkan saldo pengguna
  • POST/users/:ref/bank-accountsTambahkan rekening penerima; cek nama dan masa tunggu 24 jam
  • GET/users/:ref/bank-accountsDaftar rekening penerima pengguna
  • POST/users/:ref/withdrawalsBayarkan dana ke pengguna
  • GET/users/:ref/withdrawals/:idPantau penarikan

KYC kyc

  • POST/users/:ref/kycVerifikasi identitas penjual; membuka batas non-KYC
  • GET/users/:ref/kycBaca hasil KYC

Rating dan pengaturan ratings

  • POST/deals/:id/ratingsBeri rating pesanan yang selesai atas nama pembeli atau penjual
  • GET/users/:ref/reputationBaca reputasi pengguna (scope users)
  • GET/settingsBaca biaya, batas harian, dan scope yang diizinkan

Chat messages

  • GET/deals/:id/messagesBaca chat pesanan, setelah nomor urut tertentu
  • POST/deals/:id/messagesKirim pesan atas nama pembeli atau penjual
  • POST/deals/:id/messages/readTandai chat sudah dibaca oleh satu pihak
  • POST/deals/:id/attachmentsUnggah lampiran chat (JPG, PNG, WebP atau PDF, maks. 5 MB)
  • GET/deals/:id/attachments/:aidAmbil link bertanda tangan ke lampiran, berlaku 15 menit

Lacak pengiriman orders

  • GET/deals/:id/milestones/:mid/trackingBaca status kurir dan riwayat paket satu milestone

Invoice orders

  • GET/deals/:id/invoiceBaca invoice pesanan
POST/deals
curl -s -X POST "$API/deals" "${auth[@]}" "${json[@]}" -H "$(idem)" -d '{
  "buyer_ref": "buyer-1001",
  "seller_ref": "seller-2001",
  "title": "Fujifilm X-T30 body, used",
  "partner_order_ref": "ORD-55012",
  "milestones": [
    { "title": "Camera body", "amount": 4500000 }
  ],
  "fee_bearer": "buyer"
}'
Dibuatrespons, dipersingkat
{
  "status": "awaiting_funding",
  "platform_fee": 90000,
  "milestones": [
    {
      "status": "awaiting_payment",
      "funding_amount": 4590000,
      "payout_amount": 4500000
    }
  ]
}

Dari Sandbox ke Live

Bangun semuanya dengan uang uji dulu. Live butuh dua hal: bisnis Anda terverifikasi, dan IP allowlist di key live Anda yang sudah disetujui RekberPay.

  1. 01Sandbox

    Buat workspace

    Workspace dibuka di Sandbox dengan Platform sudah aktif dan ketentuan standar. Tidak ada yang perlu diajukan.

    Sekitar sepuluh menit, dengan NIB perusahaan Anda
  2. 02Sandbox

    Bangun dengan key rpe_test_

    Langsung berfungsi, dari IP mana pun. Tidak ada email yang keluar dari RekberPay dan tidak ada gateway yang ditagih.

    Empat jalan pintas untuk membayar, mencairkan, menyelesaikan KYC, dan melewati masa tunggu
  3. 03Diperiksa

    Verifikasi bisnis Anda

    Kirim dokumen KYB Anda. Persetujuan membuka Live dan mengaktifkan Platform di sana.

    Diperiksa dalam 1 sampai 3 hari kerja
  4. 04Live

    Mulai Live dengan key rpe_live_

    Masukkan IP server Anda di key tersebut. Sampai RekberPay menyetujuinya, panggilan live dijawab 403 IP_ALLOWLIST_REQUIRED.

    Sandbox Anda tetap ada, di samping Live
rpe_test_…IP mana pun. Hanya data uji. Webhook datang dengan livemode: false.
Sandbox
rpe_live_…Hanya dari IP yang disetujui, sampai 20 alamat atau rentang CIDR per key.
Live

Keamanan API escrow

Key Platform bisa menggerakkan uang pengguna Anda, jadi RekberPay memperlakukannya seperti kata sandi bank dan menegakkan aturannya untuk Anda.

Key

  • Hanya di sisi server. Permintaan dengan Origin browser ditolak dengan 403 KEY_IN_BROWSER.
  • Satu key per tugas: layanan pesanan dengan users dan orders, layanan pencairan dengan withdraw.
  • Key Platform Live hanya berfungsi dari IP yang disetujui RekberPay.

Permintaan

  • Setiap penulisan butuh Idempotency-Key, jadi percobaan ulang tidak pernah membuat pesanan kedua.
  • Pengguna atau pesanan milik mitra lain dijawab 404, tidak pernah 403.
  • Anda menyebut pengguna dengan ref Anda sendiri. RekberPay tidak pernah mengembalikan id internalnya.

Dana

  • Dana penjual tetap di saldo pengguna itu di RekberPay, tidak pernah di saldo Anda.
  • Penarikan live bernilai besar ditinjau RekberPay dulu sebelum dikirim.
  • Webhook ditandatangani dengan HMAC-SHA256, dengan endpoint terpisah untuk setiap mode.

FAQ escrow marketplace

Jawaban lengkap tiap pertanyaan ada di panduan mode Platform dan referensi Platform API. Untuk membandingkan kedua produk, lihat ringkasan RekberPay Enterprise.

Apakah pengguna saya harus daftar ke RekberPay?

Tidak. Server Anda membuat akun mereka dengan POST /users dan mereka tetap di situs Anda. Orang yang sudah punya akun RekberPay akan dihubungkan dan mengonfirmasi lewat email. Setiap pengguna bisa mengklaim akunnya nanti dan memakai RekberPay langsung.

Berapa biayanya?

Ketentuan standarnya 2% per pesanan dengan minimum Rp 2.500, dibayar pembeli. Anda bisa mengatur fee_bearer ke buyer, seller, atau split per pesanan. Biaya metode pembayaran ditambahkan saat checkout dan dibayar pembeli. Account manager Anda bisa mengubah ketentuan Anda, dan GET /settings selalu menampilkannya.

Bisakah platform saya mengonfirmasi penerimaan atas nama pembeli?

Hanya dengan scope orders:confirm, yang mati secara bawaan dan harus diizinkan RekberPay. Konfirmasi Anda langsung mencairkan dana dan pembeli diberi tahu. Kalau Anda ingin pembeli sempat mengajukan sengketa dulu, RekberPay bisa memasang jeda sampai 72 jam.

Siapa yang menangani sengketa?

Tim mediasi RekberPay. Anda atau pembeli membuka sengketa dan menambahkan bukti lewat API. Tim kami mencairkan, mengembalikan dana, membagi, atau melanjutkan pesanan, dan Anda menerima webhook berisi hasilnya.

Apa yang dibutuhkan untuk mulai Live?

Verifikasi bisnis Anda disetujui, yang membuka Live, dan key rpe_live_ yang IP allowlist-nya sudah disetujui RekberPay. Sandbox Anda, key-nya, dan pesanan ujinya tetap seperti semula dan tidak pindah ke Live.

Bisakah saya juga menjalankan transaksi B2B?

Bisa. Mode Platform berjalan di samping transaksi milestone B2B dalam workspace yang sama, dengan tim, key, webhook, dan Sandbox yang sama. Pakai Rekber B2B untuk membayar pemasok Anda sendiri, dan Platform API untuk pesanan antarpengguna Anda.

  • Kami membangun seluruh alurnya di sandbox dulu, lalu pindah ke live tanpa mengubah kode. Webhook yang ditandatangani cocok dengan pembukuan kami sendiri, jadi rekonsiliasi sekarang membosankan. Kalau urusannya uang, membosankan justru yang kita mau.
    RedoTemanQRIS

Jalankan pesanan pertama Anda di Sandbox hari ini

Buat workspace, buat key rpe_test_, dan bawa satu pesanan dari checkout sampai penarikan dengan uang uji. Mulai Live setelah bisnis Anda terverifikasi.

  • Sandbox gratis dengan uang uji
  • Webhook bertanda tangan per mode
  • Dukungan integrasi khusus