Dokumen API Sistem Pembayaran

dokumen-dokumen yang mirip
PANDUAN YPI AL AZHAR DAFTAR ULANG & PEMBAYARAN UANG SEKOLAH ONLINE. Joint Operation: YPI Al Azhar - Persyarikatan Al Azhar - iglobal

DAFTAR GAMBAR Gambar 13 Halaman Portal icargo Gambar 14 Edit Personal Info Gambar 15 Tambah Data Bank

Gambar 41 Isi Data DO Gambar 42 Status DO "DELIVERY ORDER RELEASED" Gambar 43 Notifikasi DO Released ke Freight Forwarder...

FAQ AKSES ADIRA FINANCE

Panduan PPDB Online. Supported by : PT. Indo Global (iglobal) Nusa Persada Copyright All rights reserved

BAB 3 RANCANGAN ARSITEKTUR

PETUNJUK SINGKAT PENDAFTARAN, MEGA TOKEN, DAN TRANSAKSI MEGA INTERNET. ELBK_Ver4.0

PANDUAN AGEN MENJADI. Edisi 2.0/2/2016/II. Kudoplex Jl. Yado 1 No. 7, Radio Dalam Jakarta Selatan

PANDUAN UGM-MALL.com

Layanan Sms OTP ( One Time Password / One Time Pin ) ADSmedia.co.id SMS OTP ( One Time Password / One Time Pin ) Sms Notifikasi Sms Reminder

USER MANUAL E-PROCUREMENT CKB (Vendor)

Aplikasi Surat Keluar Masuk Versi 1.0

Pembayaran Tagihan melalui Virtual Account Muamalat

Memulai Layanan PermataNET

TATA CARA TOP UP SALDO

Pembayaran Tagihan Virtual Account Muamalat Dan Fasilitas Upload &Download Data Tagihan Melalui Cash Management Muamalat

DAPATKAN CASHBACK HINGGA 20% SETIAP HARI

1. Menggunakan Template Jurnal

PETUNJUK PENGGUNAAN APLIKASI e- PURCHASING PRODUK BARANG/JASA PEMERINTAH PEJABAT PENGADAAN

PETUNJUK PENGGUNAAN BARANG/JASA PEMERINTAH PEJABAT PENGADAAN

Format Pelaporan Bug. Pelaporan Bug dilakukan dengan cara mengirim ke milis

INFORMASI PENCAIRAN DANA

FAQ MEGA MOBILE Apa itu layanan Mega Mobile? Apa saja syarat untuk memperoleh atau menggunakan layanan Mega Mobile?

Protokol Bandung Version 1.0

BAB IV IMPLEMENTASI DAN EVALUASI. Dalam merancang dan membangun sistem penjualan online ini ada

KETENTUAN PRIVASI DAN KONDISI PROGRAM ONLINE dibliin.com

Cara Bertransaksi Di Mandiri internet

BAB 4 IMPLEMENTASI DAN EVALUASI SISTEM

PETUNJUK PENGGUNAAN APLIKASI e- PURCHASING PRODUK BARANG/JASA PEMERINTAH PPK

1 Panduan Penggunaan

SYARAT DAN KETENTUAN NOBUPAY

MEMBUAT AKUN PAYPAL TERGANTUNG KEBUTUHAN ANDA

KINI SELURUH TRANSAKSI DI TOKOPEDIA DAPAT MELALUI DANAMON VIRTUAL ACCOUNT

Memulai. Q : Bagaimana cara mengakses Bank Ekonomi Mobile Banking? A : Kunjungi pada browser standar ponsel Anda.

TRANSFERPAY Customer Journey NICEPAY 2016

Cara Daftar PayPal Tanpa Credit Card. Panduan Singkat Bagi Anda Yang Ingin Membuat Rekening PayPal dan Memverifikasinya Tanpa Credit Card

Kementerian Lingkungan Hidup dan Kehutanan

Manual Book. PG Online

Panduan Pengguna Mobile App APLIKASI GRATIFIKASI ONLINE (GOL)

PETUNJUK PENGGUNAAN APLIKASI e- PURCHASING PRODUK BARANG/JASA PEMERINTAH ULP/PEJABAT PENGADAAN

TATA CARA REGISTRASI & TRANSAKSI BRANKAS LM

PETUNJUK PENGGUNAAN BARANG/JASA PEMERINTAH. PPK "Buat Paket"

Petunjuk Pengisian Layanan Paspor Online Versi 2.9

HOW TO DO TRANSFER ==================

USER MANUAL PERMEN. Permata Payment. For User

Panduan Penggunaan Paypal

Pembayaran Tagihan melalui Virtual Account Muamalat

Frequently Asked Questions (FAQ)

1. Melakukan Registrasi sebagai Merchant baru. 2. Cara pengiriman message Transfer for Payment

Mengubah bahasa (Indonesia dan Inggris) atau mata uang (IDR dan USD) Integrasi dengan Loyalti

FAQ LAYANAN MEGA CREDIT CARD MOBILE

PAYABLE MANAGEMENT A. IN HOUSE TRANSFER

PAUS MAHASISWA. TATA CARA REGISTRASI Padjadjaran Authentication System (PAuS ID) Mahasiswa

PETUNJUK PENGGUNAAN APLIKASI e- PURCHASING OBAT PANITIA

KETENTUAN UMUM TATA CARA PEMBAYARAN BIAYA KULIAH

Telkomsel MyAds. User Manual Direct Online VERSION 0.1

FAQ AKSES ADIRA FINANCE (Khusus Wilayah Jabodetabekser dan Jabar)

BAB IV IMPLEMENTASI DAN PENGUJIAN

Pembayaran Tagihan melalui Virtual Account Muamalat

BAB I PENDAHULUAN. 1.1 Latar Belakang

E-COMMERCE PAYMENT GATEWAY

Panduan Pengguna Individu APLIKASI GRATIFIKASI ONLINE (GOL)

Cara Bertransaksi Di Internet Banking Mandiri

1. Menggunakan Template Jurnal

BAB II TINJAUAN PUSTAKA. Bab ini membahas teori-teori yang dijadikan acuan tugas akhir ini.

FORMULIR PENGIRIMAN (CASH IN)

Panduan Penggunaan AndaraLink Web Portal (AWP) Version 1.0. Bank Andara 27 Februari 2012

Frequently Asked Questions (FAQ) Gratis Uang Saku Rp ,- dengan Aplikasi Mobile Mandiri Fiestapoin

BANK DANAMON. Panduan Penggunaan D-OPS ANDROID D-OPS

APLIKASI MEGA MOBILE BLACKBERRY

PANDUAN PENGGUNA. BINANCE.COM & INDODAX.com

LAPORAN RESMI PRAKTIKUM PENGANTAR E-BUSINESS & E-COMMERCE MODUL III PAYMENT SYSTEM & ORDERING SYSTEM. Disusun Oleh : : Ana Tsalitsatun Ni mah

USER MANUAL AKTIVASI SINGLE SIGN ON (SSO) Panduan Aktivasi Single Sign On (SSO) Untuk Mahasiswa Baru

BAB IV IMPLEMENTASI DAN EVALUASI. Agar aplikasi berjalan, dalam kegiatan implementasi aplikasi. membutuhkan perangkat keras dan perangkat lunak.

Panduan Deposit Topup 24 Jam (Mandiri) PT. Bimasakti Multiwealth

1. REGISTER BERANDA REGISTRASI RINGKASAN REGISTRASI ACTIVATION ACCOUNT... 9

Panduan Penggunaan. AndaraLink Web Portal (AWP) Version 2.2. Bank Andara 2016

FAQ LAYANAN MEGA MOBILE

ACCOUNT Q VERSI 3 PENGATURAN PROGRAM ACCOUNT Q VERSI 3 PENGATURAN PROGRAM DAFTAR PERKIRAAN DAFTAR BANK DAFTAR CUSTOMER TRANSAKSI KEUANGAN

Membuat Form Kontak yang Indah dan Atraktif dengan AJAX [Part 5]

TUTORIAL MEMBUAT AKUN PAYPAL DAN MEMVERIFIKASI MENGGUNAKAN VCC ( VIRTUAL CREDIT CARD )

PETUNJUK PENGGUNAAN BERMOTOR PANITIA

BAB IV DESKRIPSI PEKERJAAN. kertas. Pencatatan stok dilakukan dengan cara mengecek jumlah stok barang

[SPESIFIKASI H2H IP AMPM]

FAQ Mandiri Mobile. Merupakan layanan e-banking untuk melakukan transaksi finansial dan non finansial dengan

BAB I PERSYARATAN PRODUK

UNTUK GARUDA ONLINE SALES (GOS) DEPOSIT TOP UP MANAGEMENT

Panduan Edmodo Bagi Teacher Haris K, S.Pd, M.Cs.

PETUNJUK PENGGUNAAN APLIKASI e-purchasing ALAT MESIN PERTANIAN (ALSINTAN) PANITIA

Manual Guide - VAN voltras agent network. Respon ketika memasukkan user name atau password yang salah ketika log in. B. Menu Home.

workshop aplikasi teknologi informasi Proyek Akhir Facebook API Yufi Eko Firmansyah

Membuat dan Memverifikasi Akun PayPal

BAB III ANALISIS DAN PERANCANGAN SISTEM. 2. Analisa permasalahan dan perancangan sistem

USER GUIDE BII VA PAYMENT V 2.0 INSTANTICKET.COM DAFTAR ISI

Aplikasi Seller Center Lazada

Panduan Mengelola Toko Online WebKece

User Guide. System Sertifikasi LSP TIK Indonesia LSP TIK INDONESIA

BlackBerry Internet Service. Versi: Panduan Pengguna

INSTALASI APLIKASI : LANGKAH 2 : Install aplikasi dengan cara klik file kiosbank.apk yang sudah di download sebelumnya.

TATA CARA PENDAFTARAN USER ONLINE

Transkripsi:

Dokumen API Sistem

Versi Dokumen Tanggal Perubahan Catatan Revisi Deskripsi Perubahan 1.1 2019-10-12 1. Tambah field versi 2. Versi default adalah 2.1. User menempatkan jam kadaluarsa saat melakukan order. 1.2 2020-04-10 1. Me-return tipe pembayaran saat query 2. Jika pada saat melakukan transaksi atau inquiry, nilai payment_type adalah minimarket, maka ada field paybackname.. 1.3 2020-04-21 1. Tambahan alamat URL h5 dan penyesuaian parameter json pada request post. 1.4.1 2020-05-18 1. Tambahan jenis pembayaran baru bernama DOKU wallet 2. Payment_link dan payment_code sesuai untuk DOKU Wallet. 1.4.2 2020-05-25 1. Menambah alamat dan deskripsi untuk test environment 2. Menambah instruksi pembayaran. 1.4.3 2020-05-27 1. Mengatur alamat request untuk API refund. 1.4.4 2020-05-29 1. Menambah kode status error. 1.4.5 2020-06-17 1. tidak boleh melebihi 50 karakter 1.4.6 2020-06-19 1. Nama Produk tidak boleh melebihi 100 karakter 1.4.7 2020-07-24 1. Diperbarui kode untuk akun virtual 1.4.8 2020-07-30 1. Diperbarui alamat lingkungan pengujian 1.4.9 2020-08-07 1. Ubah jenis jumlah menjadi desimal (12,2) 2. Ubah alamat lingkungan pengujian 1.4.10 2020-08-25 1. Diperbarui alamat lingkungan pengujian 1.4.11 2020-08-27 1. Menambahkan antarmuka baru untuk mengunduh file rekonsiliasi 1.4.12 2020-09-21 1. Tambahkan bidang seperti nama pembayaran kembali dan jenis pembayaran saat menelepon kembali 2. Tautan H5 menambahkan bidang nomor versi

1. Ikhtisar Dokumen 1.1. Pengantar 1.2. Target Audience Target utama pembaca dokumen ini adalah implementor teknis merchant. Sebagian konten juga dapat menjadi rujukan untuk pihak manajemen dan maupun operasional merchant. 1.3. Rule Definition 1.3.1. Payment Type Jenis Kartu Kredit (Mendukung Refund) Internet Banking Virtual Account Convenience Store DANA(Mendukung refund) OVO (Pada saat pembayaran, pengguna perlu mengakses App OVO untuk melakukan transaksi pembayaran. ) AKULAKU DOKU SMS payment(hcpt is TRI) Kode CreditCard InternetBanking MaybankVA, BTNVA,BNIVA,CIMBVA,PermataVA ConvenienceStore,INDOStore DANAWALLET OVOWALLET AKULAKUWALLET DOKUWALLET TELKOMSEL_M,HCPT,XL,INDOSAT Catatan: 1. Kode ConvenienceStore merujuk ke Alfamart. 2. Link H5 disediakan oleh DANA Wallet. Ada kemungkinan ketidakcocokan dengan sistem Android. Jika ada masalah, silahkan hubungi tim teknis kami, mereka dapat memberikan code penyesuaian. 1

1.3.2. Satuan Uang 10.25 Nominal angka dalam satuan Rupiah, dengan dua angka desimal dipisah dengan titik seperti 1.3.3. Cara Mengenkripsi 1. Penggabungan Data: Asumsi seluruh data yang akan di-submit dan diterima disebut Dataset M. Nama parameter dari Dataset M disortir dari kecil ke besar (aturan sortir karakter), disusun menjadi parameter URL yang valid (seperti key1=value1&key2=value2...) kemudian digabung menjadi sebuah string yang bernama StringA. Perlu diketahui beberapa aturan berikut: Nama parameter diurut dari kecil ke besar (disortir berdasarkan karakter ASCII) Apabila nilai dari parameter kosong, maka tidak perlu ikut dienkripsi. Di dalam string awal (stringa), apabila nama parameter dan nilai parameter menggunakan data original, maka tidak perlu dilakukan URL Encode. Nilai signature dari respon sistem tidak menyertakan sign dalam proses enkripsi. Nilai enkripsi yang dihasilkan perlu dicocokkan dengan nilai sign. 2. Enkripsi Data Pada stringcontent dipasangkan dengan key akan mendapatkan string bernama stringsigntemp. Kemudian lakukan operasi MD5 pada stringsigntemp sehingga mendapat hash dan dilanjutkan ubah seluruh nilai menjadi huruf kapital, sehingga mendapatkan nilai untuk sign. 3. Contoh Asumsi berikut adalah format data yang akan di-submit: "amount":"100.00", "mchid":"0010001", "mobilephone":"16666666666", "outtradeno":"1562129320015", "channel":"creditcard", "notifyurl":"http://www.baidu.com", "tradetype":"pay.submit", "email":"111111@qq.com" 2

Langkah 1: Ubah format di atas menjadi pasangan key=value, kemudian sortir berdasarkan nama parameter secara ASCII sehingga menjadi begini: stringa="amount=100.00&channel=creditcard&email=111111@qq.com&mchid=0010001 &mobilephone=16666666666&notifyurl=http://www.baidu.com&outtradeno=1562129320 015&tradeType=pay.submit&"; Langkah 2: Gabungkan API key: stringsigntemp="stringa&key=192006250b4c09247ec02edce69f6a2d" sign=md5(stringsigntemp).touppercase()="129ab1a18ebea670accbab677cc0e6a0 " Hasil akhir data adalah sebagai berikut: "amount":"100", "mchid":"0010001", "mobilephone":"16666666666", "outtradeno":"1562129320015", "channel":"creditcard", "sign":"129ab1a18ebea670accbab677cc0e6a0", "notifyurl":http://www.baidu.com "tradetype":"pay.submit", "email":"111111@qq.com" 2. Aturan Interaksi Data and Kerahasiaan Data Metode Submit Format Encoding Karakter Format Nominal Algoritma Signature Syarat Signature Submit data dengan metode POST,pasangkan Content-Type application/json; charset=utf-8 pada form. Baik data yang di-submit maupun diterima dalam format JSON Diseragamkan dengan encoding karakter UTF-8 Jumlah dalam format rupiah Indonesia, dengan dua angka di belakang koma. MD5 Perlu adanya verifikasi nilai pada signature pada saat me-request 3

maupun menerima data. Untuk info selengkapnya cek subbab Digital Signature. Logika Kondisional Pertama-tama cek kode return, baru cek return value, terakhir cek status transaksi. 3. API 3.1 Ordering Interface URL Produksi: https://wayangpay.co.id/api-pay/pay/transfer URL Testing: https://sit.wayangpay.co.id/api-pay/pay/transfer Parameter test akan disediakan oleh staf operasional. Di environment testing, apabila transaksi berhasil di-submit maka sistem akan otomatis mengirim callback 3 menit kemudian. Jika merchant terhubung dengan environment testing, sistem akan memberikan prioritas ke transfer transaksi, dan tampilan callback untuk tipe pembayaran va. 3.1.1. Parameter Request Nama Field Variabel Tipe Data Mandatori Deskripsi mchid String(20) Ya unik untuk merchant yang diberikan oleh Payment Gateway Versi version String(4) Ya 2.1 (di-hardcode 2.1 ) Metode channel String(10) Ya Jenis pembayaran outtradeno String(50) Ya order yang dibuat oleh merchant. Bersifat unik di dalam sistem merchant. Jumlah Transfer amount decimal(12,2) Ya Nominal dalam satuan rupiah, dengan dua angka belakang koma, dan desimal menggunakan tanda titik. Khusus VA payment, jumlahnya tidak boleh lebih rendah dari channel fee merchant (biaya dalam kontrak). Nilai transaksi Wallet 4

harus lebih dari IDR 100. Jenis tradetype String(20) Ya Di-hardcode pay.submit Telepon mobilephone String(20) Ya telepon pelanggan Email email String(45) Ya Email URL Notifikasi notifyurl String(200) Tidak Setelah pembayaran selesai maka akan kirim notifikasi ke URL tersebut; URL Callback callbackurl String(200) Tidak Nama Pembayar payer String(60) Ya Nama Produk goodsinfo String(100) Tidak Signature sign String(32) Ya Ketika transaksi berhasil atau gagal, sistem akan redirect ke URL ini. Wayangpay akan menyertakan nomor transaksi dari merchant ke dalam URL seperti callbackurl?orderno=123456, sehingga bisa query transaksi dari nomor yang diberikan. Nama orang yang melakukan transaksi Informasi Produk, diisi saat nomor versi adalah 2.1 Silahkan merujuk ke 1.3.3 Cara Enkripsi 3.1.2. Parameter Respon Nama Field Variabel Tipe Data Mandatori Deskripsi Kode Respon returncode String(1) Ya 0:Sukses 1: Gagal Deskripsi Respon returnmsg String(128) Tidak Penjelasan kode respon. Penjelasan termasuk dalam bahasa Mandarin. Berikut adalah parameter yang muncul apabila returncode bernilai 0 Link pembayaran atau Kode paycode String(200) Tidak Selain jenis Kode, seluruh jenis pembayaran lainnya ada respon; Berikut aturannya: 01: URL ; 5

outtradeno String(50) Ya 04: Format JSON dari Payment channel atau Payment Code order yang dibuat oleh merchant. Maksimal 50 karakter, bisa mengandung alfabet dan harus bersifat unik di dalam sistem merchant. Platform Waktu outchannelno String(32) Tidak transaksi di platform transtime String(16) Ya yyyymmddhhmmss Batas Waktu expiredtime String(16) Ya yyyymmddhhmmss ( Dikarenakan proses sinkronisasi waktu dan jeda polling, bisa terjadi perbedaan waktu kadaluarsa dibandingkan dengan waktu sesungguhnya.) Nominal Transfer amount Number Ya Nominal transaksi dalam satuan Rupiah, dengan dua angka belakang koma, dan desimal menggunakan titik. Kode Error errcode String(32) Tidak Silahkan merujuk ke Lampiran Daftar Error. Deskripsi Kode Error errcodedes String(128) Tidak Deskripsi terkait kode error mchid String(20) Tidak Jenis Nama Pembayar paycodeway String(2) Tidak paybackname String(100) Tidak 01:URL ; 04:Format JSON untuk Payment channel atau Payment Code Field ini akan muncul jika request-nya menggunakan versi 2.2 dan payment_type diisi convenient store Signature sign String(32) Ya Signature, untuk detailnya lihat cara enkripsi. 6

3.1.3. Contoh Contoh Format Request: "amount": "10000.00", "mchid": "0010001", "mobilephone": "16666666666", "outtradeno": "1578982657657", "channel": "MaybankVA", "sign": "B6338203092F1BD0A9DAB651758EEACE", "notifyurl": "http://192.168.0.165:8080/trans/notify", "callbackurl": "http://www.baidu.com", "payer": "zhangsan", "version": "2.1", "tradetype": "pay.submit", "email": "16666666666@qq.com" Contoh format respon: "returncode": "0", "sign": "608229914A59CF67FD95C814A22D5A37", "outtradeno": "1578982657657", "outchannelno": "2020011400000017935", "paycodeway": "04", "paycode": "7879600114000004", "amount": 10000.00, "transtime": "20200114131850", "expiredtime": "20200115131850" 3.2 Alamat H5 Kelebihan dari dengan Alamat H5 adalah tidak perlunya programming untuk membuat halaman pembayaran lagi. WayangPay menyediakan halaman pembayaran untuk menuntun pembeli untuk menyelesaikan proses pembayarannya. Terkait query detail order, notifikasi transaksi berhasil (notifyurl), Url callback (callbackurl), semuanya menggunakan metode yang sama persis. Sehingga programmer bisa memilih salah satu caranya. 7

3.2.1 Contoh Alamat Alamat Production: https://wayangpay.co.id/payer-api/pay-h5 Alamat Testing: https://sit.wayangpay.co.id/payer-api/pay-h5 3.2.2 Parameter Respon Ketika merchant mengirim suatu transaksi, panjang nomor transaksi harus sesuai dengan petunjuk dokumen dan tidak melebihi batas. versi saat melakukan pemesanan adalah 2.2 Nama Field Variabel Tipe Data Mandatori Deskripsi Jenis Jumlah mchid String(20) Ya channel String(10) Tidak orderno String(50) Ya amount decimal(12,2) Ya unik untuk merchant yang diberikan oleh Payment Gateway Jenis pembayaran. Silahkan lihat Jenis ; Jika dikosongkan maka akan muncul halaman H5 agar pembeli yang memilih jenis pembayaran. transaksi yang ada di dalam sistem merchant. Bersifat unik di dalam sistem merchant. Nominal dalam satuan rupiah, dengan dua angka belakang koma, dan desimal menggunakan tanda titik. Khusus VA payment, jumlahnya tidak boleh lebih rendah dari channel fee merchant (biaya dalam kontrak). Nilai transaksi Wallet harus lebih dari IDR 100. Telepon mobilephone String(20) Ya handphone customer. Nama Produk goodsinfo String(100) Ya Nama barang yang dibeli oleh pembeli. 8

Url target notifikasi Url target callback notifyurl String(200) Tidak callbackurl String(200) Ya Setelah pembayaran selesai, sistem harus kirim notifikasi ke URL mana. Parameter yang dikirim dalam notifikasi terkait detail inquiry. Ketika transaksi berhasil maupun gagal, sistem akan redirect ke URL ini. Pada saat redirect Wayangpay akan menyertakan nomor transaksi seperti callbackurl?orderno=123456, sehingga merchant dapat mencari transaksi berdasarkan nomor tresebut. Versi version String(10) Tidak versi default yang tidak disetel adalah 2.2 Bahasa lang String(10) Tidak Signature sign String(32) Ya Secara default menggunakan bahasa Indonesia. Untuk mengubah ke Inggris, isi en Signature, Lihat 1.3.3Cara Mengenkripsi. 3.2.3 Parameter Respon Nama Field Variabel Tipe Data Mandatori Deskripsi Return code returncode String(20) Ya 0:Success 1:failure H5 address returned Error description url String(10) Tidak errcodedes String(100) Tidak Jenis pembayaran. Jika jenis pembayaran kosong, maka akan terbuka halaman H5. Maka pembeli bisa memilih sendiri jenis pembayaran. Respon jika nilai kode respon adalah 0.. Ketika nilai returncode adalah 1, maka me-return deskripsi error. 9

3.2.4 Contoh Contoh format request: Disumbit dengan POST, parameter pakai format json "mchid":"0010001", "mobilephone":"16666666666", "amount":"10000.00", "callbackurl":"http://www.baidu.com", "goodsinfo":"wash machine", "orderno":"12345678925613", "notifyurl":"www.baidu.com" Contoh format respon: "returncode":"0", "url":"https://wayangpay.co.id/payer/in-home-index.html?notifyurl=www.baidu.com&amount= 10000.00&callbackUrl=http://www.baidu.com&goodsInfo=wash machine&mchid=0010001&out TradeNo=12345678925613&sign=7ea39fee1f8554e9f39d16e1bc6e0924" 3.2.5 Follow-up Setelah pembeli klik bayar, mereka akan masuk ke halaman pembayaran H5 Wayangpay. Dari situ akan dituntun untuk proses pembayaran. Jika pembayaran berhasil, maka merchant, menerima notifikasi bahwa transaksi berhasil melalui notifyurl, dan pembeli akan kembali ke halaman/aplikasi merchant melalui callbackurl. 3.3 Meng-inquiry Status Detail Order Official address:https://wayangpay.co.id/api-pay/pay/query Test address:https://sit.wayangpay.co.id/api-pay/pay/query 3.3.1 Parameters Request Nama Field Variabel Tipe Data Mandatori Deskripsi Jenis tradetype String(20) Ya Di-hardcode trade.query Versi version String(4) Ya Diisi 2.1 atau 2.2. versi 2.2 meliputi semua fitur versi 2.1 dan bisa 1

mchid String(10) Ya outtradeno String(50) Ya me-return field paychanneltype dan memberitahukan merchant tipe pembayaran unik untuk merchant yang diberikan oleh Payment Gateway order yang dibuat oleh merchant. Bersifat unik di dalam sistem merchant. Jenis Query querytype String(1) Ya Signature sign String(32) Ya 1: 2: Refund Silahkan merujuk ke 1.3.3 Cara Enkripsi 3.3.2 Parameter Respon Nama Field Variabel Tipe Data Mandatori Deskripsi Kode Status Respon returncode String(1) Ya 0: Sukses, 1:Gagal (bukan status transaksi) Deskripsi Respon returnmsg String(128) Tidak Penjelasan kode respon. Penjelasan termasuk dalam bahasa Mandarin. Berikut adalah parameter yang muncul apabila returncode bernilai 0 Platform outtradeno String(50) Ya outchannelno String(32) Tidak order yang dibuat oleh merchant. Maksimal 50 karakter, bisa mengandung alfabet dan harus bersifat unik di dalam sistem merchant. transaksi platform Waktu Dibuat Waktu transtime String(16) Ya yyyymmddhhmmss tradepaytime String(16) Tidak yyyymmddhhmmss Batas Waktu expiredtime String(16) Ya yyyymmddhhmmss 11

Link atau Kode Nominal paycode String(200) Ya amount decimal(12,2) Ya dana wallet, credit card, ovo wallet, akulaku wallet, doku wallet returns url link, the rest return va code Nominal transaksi dalam satuan Rupiah, dengan dua angka di belakang koma, dan desimal dengan tanda titik. Kode Error errcode String(32) Tidak Silahkan merujuk ke lampiran Daftar Error Deskripsi Error errcodedes String(128) Tidak Deskripsi dari Error ID mchid String(10) Ya ID Hanya ada respon jika berupa jenis query adalah Status status String(2) Tidak 01:Belum bayar 02:Sudah bayar 05:Refund transfer 09: gagal Status Refund refundstatus String(2) Tidak Hanya ada respon jika berupa jenis query adalah Refund 02: Refund berhasil 03: Proses Refund 05: Refund Gagal Tipe Query querytype String(1) Ya 1. Pesan 2. Refund Tipe Nama paychanneltype String(32) Tidak paybackname String(100) Tidak Saat versi adalah 2.2 akan me-return Saat versi adalah 2.2, jika tipe pembayaran adalah minimarket akan me-return Signature sign String(32) Ya Signature, silahkan cek cara enkripsi. 1

3.3.3 Contoh Contoh format request: "tradetype":"trade.query", "mchid":"0010001", "version":"2.1", "outtradeno":"1562142875641", "querytype":"1", "sign": "660B6B5BF40D2EDC54661400ADDBB15F" Contoh format respon: "returncode":"0", "sign":"35ba9679e9d67881271164ebb4ed85fe", "outchannelno":"201907030100000026", "status":"02", "mchid":"0010001", "outtradeno":"1562142875641", "amount":100.00, "paycode":"0703163536", "tradepaytime":"20190703163536", "expiredtime":"20190703173040", "transtime":"20190703163036" 4. Notifikasi Asynchronous Callback Server akan mengirim request POST dalam format JSON. Mohon untuk me-return SUCCESS tanpa tanda kutip setelah mendapat notifikasi dari sistem kami. Sistem akan terus mengirim notifikasi beberapa kali selama tidak mendapat respon (total sebanyak 8 kali). Jarak waktu notifikasi adalah 1 detik, 5 detik, 10 detik, 30 detik, 60 detik, 300 detik, 900 detik dan 1800 detik. 1

Nama Field Variabel Tipe Data Mandatori Deskripsi Kode Status Respon Deskripsi Respon returncode String(1) Ya returnmsg String(128) Tidak 0:Sukses 1:Gagal( Bukan status transaksi) Penjelasan kode respon. Penjelasan termasuk dalam bahasa Mandarin. Waktu Waktu Selesai Platform transtime String(16) Ya yyyymmddhhmmss tradepaytime String(16) Ya yyyymmddhhmmss outchannelno String(30) Tidak 2019102202900005956 outtradeno String(50) Ya Dibuat saat merchant melakukan transaksi Waktu Kadaluarsa Link atau Kode Nominal Nama Tipe epiredtime String(16) Ya yyyymmddhhmmss paycode String(200) Ya amount decimal(12,2) Ya paybackname String(30) Tidak Saat melakukan pemesanan, pesanan akan dikembalikan jika nomor versi 2.2. versi pemberitahuan h5 adalah 2.2 secara default paychanneltype String(30) Tidak Saat melakukan pemesanan, pesanan akan dikembalikan jika nomor versi 2.2. versi pemberitahuan h5 adalah 2.2 secara default Kode Error errcode String(32) Tidak Silahkan merujuk ke lampiran Daftar Error Deskripsi Error errcodedes String(128) Tidak Deskripsi terhadap kode error Signature sign String(32) Ya Silahkan merujuk ke 1.3.3 Cara 1

Status status String(2) Ya Mengenkripsi 01:Belum Bayar 02:Sudah Bayar 05:Refund Transfer 09: Gagal mchid String(20) Response example "returncode":"0", "sign":"0969da1740f4641500e72bf0f64c4d29", "outchannelno":"2020091816800000034", "paycode":"6476296313631938", "status":"02", "mchid":"010168", "paybackname":"wayangpay/wayangpay Via Nicepay", "outtradeno":"200918131906789005", "amount":10000.00, "transtime":"20200918132839", "tradepaytime":"20200918132941", "expiredtime":"20200918133339", "paychanneltype":"indostore" 5. Refund 5.1.1. API Refund Alamat Production:https://wayangpay.co.id/api-pay/pay/refund Alamat Testing:https://sit.wayangpay.co.id/api-pay/pay/refund Perhatian: Saat ini hanya Kartu Kredit, Dana Wallet yang mendukung refund.. 5.1.2. Parameter Request Nama Field Variabel Tipe Data Mandatori Deskripsi mchid String(20) Ya unik untuk merchant yang diberikan oleh Payment 1

Jenis Nominal channel String(10) Ya outtradeno String(50) Ya amount decimal(12,2) Ya Gateway Jenis pembayaran, silahkan merujuk ke Jenis. order yang dibuat oleh merchant. Bersifat unik di dalam sistem merchant. Nominal dalam satuan Rupiah dan dua angka di belakang koma, desimal ditandai dengan titik. Jenis tradetype String(20) Ya Di-hardcode refund.apply Refund Alamat pemberitahuan asinkron pengembalian outrefundno String(32) Ya notifyurl String(200) Tidak transaksi yang ingin di-refund merchant. URL yang menerima notifikasi apabila proses refund selesai. Parameter merujuk pada quer y terperinci transaksi. Signature sign String(32) Ya Silahkan merujuk ke 1.3.3 Cara Enkripsi. 5.1.3. Parameter Respon Nama Field Variabel Tipe Data Mandatori Deskripsi Kode Status Respon returncode String(1) Ya 0:Sukses 1:Gagal Deskripsi Respon returnmsg String(128) Tidak Penjelasan kode respon. Penjelasan termasuk dalam bahasa Mandarin. Berikut adalah parameter yang muncul apabila returncode bernilai 0 outtradeno String(50) Ya order yang dibuat oleh merchant. Maksimal 50 karakter, bisa mengandung alfabet dan harus bersifat unik di dalam sistem merchant. 1

Platform order number channelrefundno String(32) Tidak order platform Refund Status Refund outrefundno String(32) Tidak refundstatus String(2) Tidak transaksi yang ingin di-refund oleh merchant. 02:Refund berhasil 03:Sedang proses refund 05:Refund gagal Kode Error errcode String(32) Tidak Silahkan merujuk ke lampiran Daftar Error Deskripsi Kode Error errcodedes String(128) Ya Penjelasan dari kode error. Signature sign String(32) Ya Signature, merujuk ke 1.3.3 algoritma enkripsi. 5.1.4. Contoh Contoh format request: "amount":"100", "mchid":"0010001", "outrefundno":"1562309398129", "outtradeno":"t1562309523590", "channel":"creditcard", "sign":"714c3c55e40982622ab96771140851c7", "notifyurl":"http://www.baidu.com", "tradetype":"refund.apply" Contoh format respon: "returncode":"0", "sign":"3d6205701ce3f876ffb320db8b234c68", "outrefundno":"1562309398129", "outtradeno":"t1562309523590", "channelrefundno":"201907050200000034", 1

"refundstatus":"02" 6. Unduh definisi antarmuka file penerimaan dan rekonsiliasi 6.1.1 Unduh antarmuka file perintah pembayaran Lingkungan formal: https://wayangpay.co.id/api-pay/settle/orderfile Catatan: Gunakan metode get untuk memanggil antarmuka, format parameter harus json, dan urutan yang diperoleh antarmuka adalah urutan tetap. 6.1.2 Parameter permintaan Nama bidang Jenis variabel Deskripsi Diperlukan nomor bisnis mchid String(20) Iya Pengidentifikasi unik pedagang yang diberikan oleh sistem pembayaran kepada mitra Tanggal sukses date String(10) Iya Tanggal sukses pesanan, seperti: 2020-08-26, harus kurang dari tanggal saat ini tanda tangan sign String(32) Iya Tanda tangan, lihat 1.3.3 Algoritma Pembuatan Tanda Tangan untuk detailnya 6.1.3 Parameter respons Responnya berupa file teks dengan nama file payment_order_xxx.txt, dimana format xxx seperti 20200826. 1

6.1.4 Contoh Contoh alamat permintaan kirim permintaan: "mchid":"0010001", "date":"2020-08-26", "sign":"714c3c55e40982622ab9677341140851c7" Hasil pengembalian: File teks bernama payment_order_20200826.txt. Deskripsi: Parameter file payment_order_xxx.txt dipisahkan oleh pemisah " ", dengan urutan: nomor pedagang saluran produk saluran nomor seri jumlah waktu inisiasi tarif total biaya penanganan nomor pesanan platform nomor pesanan pedagang Waktu sukses Kode VA 7. Error Code Kode Error Deskripsi noauth paramerror outtradenoused signerror systemerror mchinvalid postdataempty channeliserror amountseterror phonenotnull payernotnull merchantordernotnull merchantordernolengthexceeds tidak belum membuka hak akses untuk API ini. Format parameter salah. order merchant ada yang duplikat Kesalahan Signature Kesalahan sistem tidak valid Nilai Post kosong Jenis tidak benar Jumlah tidak benar telepon tidak boleh kosong. Nama Pembayar tidak boleh kosong transaksi merchant tidak boleh kosong. Panjang transaksi merchant tidak boleh lebih dari 50 karakter. 1