Direct Debit

Ringkasan

Layanan ini digunakan untuk memungkinkan pengguna melakukan pembayaran dari platform pedagang dengan diarahkan ke platform Paydia. Informasi detail akan dijelaskan pada bagian selanjutnya.

Spesifikasi API Paydia akan mencakup 2 endpoint utama, yaitu:

No	Nama API	Deskripsi
1	Pembayaran Debit Langsung	API ini digunakan untuk menginisiasi pembayaran dari platform pedagang ke Paydia
2	Pemberitahuan Pembayaran Debit Langsung	API ini digunakan untuk memberitahukan status pembayaran dan informasi dari Paydia ke platform pedagang

Pembuatan dan Validasi Signature

Berikut akan dijelaskan tentang Pembuatan dan validasi Signature.

Simetris dengan Akses Token B2B (HMAC_SHA512)

Langkah-langkah berikut akan menjelaskan Simetris dengan Akses Token B2B (HMAC_SHA512).

Pembuatan Signature Digital

Terapkan Signature Token B2B

1. Rangkai string yang akan ditandatangani:

X-CLIENT-KEY + "|" + X-TIMESTAMP

2. String Signature dihasilkan dari string yang akan ditandatangani di atas dengan menerapkan enkripsi SHA-256 dengan kunci privat pkcs8, dan kemudian kodekan hasilnya ke base64.
3. Letakkan string Signature ke dalam header HTTP “X-SIGNATURE“ saat memanggil API untuk menerapkan akses token B2B.

Signature Transaksi

1. Rangkai string yang akan ditandatangani:

HTTP METHOD + ”:” + URL PATH RELATIF + “:“ + TOKEN AKSES B2B + “:“ + LowerCase(HexEncode(SHA-256(Minify(HTTP BODY)))) + “:“ + X-TIMESTAMP

2. String Signature dihasilkan dari string yang akan ditandatangani di atas dengan menerapkan enkripsi HMAC_SHA512 menggunakan kunci rahasia yang diberikan oleh Paydia, dan kemudian kodekan hasilnya ke base64.
3. Letakkan string Signature ke dalam header HTTP “X-SIGNATURE“ saat memanggil API Paydia.

Validasi Signature Digital

Terapkan Signature Token B2B

Berikut adalah langkah-langkah Pembuatan Signature digital:

1. Ambil Signature dari header HTTP “X-SIGNATURE“.
2. Dekripsi Signature menggunakan kunci publik yang sesuai dengan kunci privat yang digunakan untuk menghasilkan Signature.
3. Verifikasi kebenaran Signature berdasarkan enkripsi SHA-256 dengan enkripsi RSA-2048 terhadap string yang akan ditandatangani.
4. Jika verifikasi benar, maka terima pesan tersebut.

Signature Transaksi

1. Rangkai string yang akan ditandatangani:

HTTP METHOD + ”:” + URL PATH RELATIF + “:“ + TOKEN AKSES B2B + “:“ + LowerCase(HexEncode(SHA-256(Minify(HTTP BODY)))) + “:“ + X-TIMESTAMP

2. Hasilkan Signature dari string yang akan ditandatangani di atas dengan menerapkan enkripsi HMAC_SHA512 menggunakan kunci rahasia yang diberikan oleh Paydia, dan kemudian kodekan hasilnya ke base64.
3. Ambil Signature dari header HTTP “X-SIGNATURE“.
4. Bandingkan nilai antara X-SIGNATURE dan Signature yang dihasilkan, jika nilai tersebut sama, maka terima pesan tersebut.

Asimetris tanpa Akses Token (SHA256withRSA)

Langkah-langkah berikut akan menjelaskan Asimetris tanpa Akses Token (SHA256withRSA).

Pembuatan Kunci Asimetris

Berikut akan dijelaskan tentang Pembuatan kunci asimetris:

• Buat Kunci Privat

openssl genrsa -out rsa_private_key.pem 2048

• Ekspor Kunci Publik

openssl rsa -in rsa_private_key.pem -out rsa_public_key.pem -pubout

• Kodekan Kunci Privat ke PKCS#8

openssl pkcs8 -topk8 -in rsa_private_key.pem -out pkcs8_rsa_private_key.pem -nocrypt

Mitra harus menghasilkan Signature dengan pkcs8_rsa_private_key.pem, dan Paydia akan menggunakan rsa_public_key.pem untuk memvalidasi Signature dan sebaliknya.

Pembuatan Signature Digital

Berikut adalah langkah-langkah Pembuatan Signature digital:

1. Rangkai string yang akan ditandatangani:
• Terapkan token:

X-CLIENT-KEY + "|" + X-TIMESTAMP

• Transaksional:

HTTP METHOD + ”:” + URL PATH RELATIF + “:“ + LowerCase(HexEncode(SHA-256(Minify(HTTP BODY))) + “:“ + X-TIMESTAMP

2. String Signature dihasilkan dari string yang akan ditandatangani di atas dengan menerapkan enkripsi SHA-256 dengan enkripsi RSA-2048 menggunakan kunci privat pkcs8, dan kemudian kodekan hasilnya ke base64.
3. Letakkan string Signature ke dalam header HTTP “X-SIGNATURE“.

Contoh:

X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

Validasi Signature Digital

Berikut adalah langkah-langkah validasi Signature digital:

1. Ambil Signature dari header HTTP “X-SIGNATURE“.
2. Dekripsi Signature menggunakan kunci publik yang sesuai dengan kunci privat yang digunakan untuk menghasilkan Signature.
3. Verifikasi kebenaran Signature berdasarkan enkripsi SHA-256 dengan enkripsi RSA-2048 terhadap string yang akan ditandatangani.
4. Jika verifikasi benar, maka terima pesan tersebut.

Versi Dokumen

Tabel berikut digunakan untuk menunjukkan versi dokumen ini:

No	Tanggal	Versi	Catatan	Halaman
1	10 Mei 2023	1.2.2	Menghapus TOKEN AKSES B2B dalam Pembuatan Signature Digital Menghapus bagian Kode Respon Umum	Layanan - Debit Langsung
2	4 November 2022	1.1.0	Release Awal	Semua yang terkait dengan PayConnect