Kembalikan dana

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pengantar

Monetisasi memungkinkan Anda memposting pengembalian dana kepada developer untuk "transaksi pembelian". Misalkan Anda adalah operator seluler dan menawarkan API pembayaran kepada developer untuk menagih pelanggan seluler atas pembelian aplikasi atau konten dalam aplikasi. Setiap kali pelanggan menggunakan API untuk melakukan pembelian, hal tersebut merupakan transaksi pembelian.

Transaksi pembelian dapat menghasilkan pengembalian dana. Misalnya, konten tersebut mungkin tidak ditayangkan, atau pihak ketiga tidak puas dengan pembelian tersebut. Dalam kasus tersebut, developer memberikan pengembalian dana kepada pihak ketiga. Dengan monetisasi, Anda dapat melakukan pengembalian dana yang setara. Hal ini terutama berkaitan dengan rencana pembagian keuntungan.

Bayangkan jika developer yang melakukan pengembalian dana kepada pelanggan seluler membeli paket pembagian keuntungan untuk produk API Anda. Misalkan paket meminta developer untuk menerima 70% dari harga bersih/kotor dari transaksi pembelian. Dengan memposting pengembalian dana, pada dasarnya Anda akan mengembalikan transaksi pembelian, yaitu mengurangi 70% dari pembayaran yang harus dibayarkan kepada developer untuk bulan saat pengembalian dana diterapkan (bulan mungkin berbeda dengan bulan saat transaksi pembelian sebenarnya terjadi).

Memposting pengembalian dana menggunakan UI Classic Edge (khusus Edge untuk Private Cloud)

Anda dapat memposting pengembalian dana untuk setiap transaksi pembelian yang "berhasil", yaitu saat API berhasil menagih pihak ketiga dan yang belum dikembalikan dananya sepenuhnya. Memposting pengembalian dana akan membuat transaksi pengembalian dana dengan ID transaksi induk, dengan ID transaksi yang berupa ID transaksi pembelian.

Anda dapat memposting pengembalian dana untuk nilai penuh dari transaksi pembelian awal atau sebagian. Anda juga dapat memposting beberapa pengembalian dana sebagian, tetapi jumlah total pengembalian dana tidak boleh lebih dari jumlah pembelian awal.

Untuk memposting pengembalian dana:

  1. Di tab Monetisasi, pilih Pengembalian Dana.

    Tindakan ini akan membuka halaman Pengembalian Dana.

  2. Pada menu drop-down Bulan Penagihan, pilih bulan saat transaksi pembelian terjadi. Lalu, klik + Pengembalian dana.

    Tindakan ini akan menampilkan daftar semua transaksi pembelian yang berhasil untuk bulan yang dipilih.

    Anda dapat memfilter daftar pengembalian dana berdasarkan nama developer atau dengan menelusuri transaksi sebenarnya.

    Untuk memfilter menurut developer, pilih developer dari menu drop-down Developer. Tindakan ini hanya akan menampilkan daftar transaksi yang terkait dengan developer yang dipilih.

    Untuk memfilter berdasarkan ID transaksi, masukkan ID transaksi pembelian asli yang ingin Anda kembalikan dananya. Tindakan ini akan menampilkan transaksi untuk ID tersebut.

  3. Centang kotak Pilih di baris untuk transaksi yang ingin Anda kembalikan dananya.
  4. Pilih Total atau Sebagian di menu drop-down Jenis.

    Jika Anda memilih Total, jumlah total pembelian akan dikembalikan. Jika Anda memilih Sebagian, dana sebagian dari pembelian akan dikembalikan.

    Jika Anda memilih Sebagian, masukkan jumlah pengembalian dana sebagian di kolom Jumlah. Anda hanya dapat melakukan pengembalian dana hingga sejumlah total pembelian. Jika sudah memposting pengembalian dana sebagian, Anda hanya dapat memasukkan jumlah hingga sisa jumlah pembelian. Selain itu, jika transaksi pembelian asli memiliki harga kotor dan bersih, Anda juga harus menyatakan apakah jumlah sebagian yang ingin dikembalikan dananya adalah harga kotor atau bersih.

  5. Klik Simpan untuk memproses pengembalian dana (atau Batal untuk membatalkan).

    Pengembalian dana akan diposting ke bulan pembelian awal jika bulan penagihan masih terbuka. Jika tidak, pengembalian dana akan diposting ke tanggal saat ini.

    Untuk pengembalian dana sebagian, pengembalian dana akan diproses untuk jumlah sebagian dan bagi hasil dipotong berdasarkan proporsi jumlah sebagian dari jumlah seluruhnya. Dalam contoh pengembalian dana sebagian di atas, jumlah sebagiannya adalah 0,50/1,12 = 45% dari harga kotor, sehingga dipotong 45% dari pembagian keuntungan developer.

Memeriksa di UI apakah pengembalian dana telah diproses

Anda dapat mengetahui apakah pengembalian dana telah diproses dengan memilih bulan penagihan di bagian atas halaman Pengembalian Dana. Ini adalah bulan pembelian jika bulan penagihan masih terbuka, atau bulan berjalan jika bulan penagihan ditutup. Tindakan ini akan menampilkan daftar semua pengembalian dana yang telah diposting pada bulan tersebut.

Memposting pengembalian dana menggunakan API

Untuk memposting pengembalian dana, kirimkan permintaan POST ke /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, dengan {package_id} adalah identifikasi paket API yang berlaku untuk pengembalian dana.

Saat mengajukan permintaan, Anda harus menentukannya sebagai parameter kueri:

  • Identifikasi transaksi pembelian yang dananya dikembalikan.
  • Jenis pendapatan (GROSS atau NET) dari transaksi pembelian.
  • Jumlah pengembalian dana.
  • Catatan yang menjelaskan alasan pengembalian dana.

Atau, Anda dapat mengidentifikasi paket API sebagai parameter URL yang menerapkan pengembalian dana.

Lihat Setelan konfigurasi pengembalian dana untuk melihat daftar lengkap parameter URL yang dapat Anda tentukan dalam permintaan pengembalian dana.

Misalnya, permintaan berikut memberikan pengembalian dana untuk transaksi pembelian. Jumlah pengembalian dana adalah 50% dari jumlah kotor transaksi pembelian.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

Responsnya akan terlihat seperti ini (hanya sebagian respons yang ditampilkan):

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

Setelan konfigurasi pengembalian dana untuk API

Parameter kueri berikut dapat ditentukan dalam permintaan pengembalian dana:

Nama Deskripsi Default Wajib diisi?
monetizationPackageId

Paket API yang mengembalikan dana.

 T/A Tidak
parentTxId

Transaksi pembelian yang akan dikembalikan dananya.

 T/A Ya
revenueType

Jenis pendapatan (GROSS atau NET) dari transaksi pembelian.

 T/A Ya
refundAmount

Jumlah pengembalian dana.

 T/A Ya
transactionNote

Catatan teks yang menjelaskan alasan pengembalian dana.

 T/A Ya

Langkah berikutnya

Pelajari cara menjadwalkan tugas terkait monetisasi dan tentang tugas yang dijadwalkan secara otomatis dalam Menjadwalkan tugas monetisasi.