wechatpay postman script

Skrip tukang pos APIv3 pembayaran WeChat

Skrip pra-permintaan permintaan tukang pos API Pembayaran WeChatv3 (Skrip Pra-Permintaan).

Untuk membantu pengembang pedagang memulai dengan cepat, kami menerapkan skrip ke meja kerja cloud Postman WeChat Pay Public Workspace. Anda tidak perlu mengimpor skrip secara manual, Anda hanya perlu mem-fork koleksi "WeChat Payment APIv3" ke meja kerja Anda, dan Anda dapat dengan mudah membuat dan mengirim permintaan WeChat Payment APIv3 di Postman.

Prasyarat

• Tukang pos, platform industri terkenal untuk membangun dan menggunakan API. Disarankan untuk mendaftarkan akun untuk menggunakan berbagai fungsinya.
• Menjadi pedagang pembayaran WeChat.
• Kunci pribadi Merchant API: Saat pedagang mengajukan permohonan sertifikat API pedagang, kunci pribadi pedagang akan dibuat dan disimpan dalam file apiclient_key.pem di folder sertifikat lokal.

mulai cepat

Langkah 1: Skrip impor garpu

Klik tombol untuk masuk ke wizard, seperti yang ditunjukkan di bawah ini.

Klik Fork Collection untuk melanjutkan ke langkah berikutnya, isi label Fork Label dan pilih ruang kerja tujuan Workspace . Dalam keadaan normal, cukup mengimpor meja kerja pribadi My Workspace.

Klik Fork Collection untuk menyelesaikan impor. Anda dapat melihat "API Pembayaran WeChatv3" di ruang kerja yang Anda tentukan.

Anda juga dapat mengimpor skrip secara lokal.

Langkah 2: Konfigurasikan Lingkungan

Lingkungan adalah kumpulan variabel. Skrip membaca variabel dari lingkungan dan menggunakannya untuk menghitung tanda tangan permintaan.

Anda dapat membagi lingkungan kosong dari templat parameter pedagang yang disediakan oleh "WeChat Payment APIv3" ke meja kerja Anda sendiri.

Selanjutnya, temukan lingkungan yang baru dibuat di Lingkungan di meja kerja Anda dan klik Add a new varialbe untuk menambahkan variabel baru:

• mchid : wajib, nomor pedagang.
• merchant_serial_no : wajib diisi, nomor seri sertifikat API merchant.
• apiclient_key.pem : Diperlukan, kunci pribadi API pedagang dalam format PEM.

PeringatanDemi keamanan, harap baca tindakan pencegahan keselamatan dengan cermat.

Serangkaian konfigurasi umum ditunjukkan di bawah ini.

Langkah 3: Kirim permintaan

Catatan: Kami merekomendasikan penggunaan aplikasi Postman desktop untuk mengirim permintaan, yang lebih cepat dan memiliki pengalaman lebih baik!

Sekarang kembali ke meja kerja, masuk ke koleksi "WeChat Payment APIv3", dan pilih permintaan yang ingin Anda kirim.

Kemudian, isi parameter permintaan dan ubah parameter di Body sesuai dengan komentar.

Terakhir, pilih Lingkungan yang Anda konfigurasikan sebelumnya dan klik tombol Send di sisi kanan bilah alamat untuk mengirim permintaan.

Prinsip implementasi

Pre-Request Script adalah skrip Javascript. Tukang pos menjalankan skrip ini sebelum mengirim permintaan. Skrip melakukan hal berikut:

1. Memuat perpustakaan yang bergantung
2. Baca variabel parameter pedagang di Lingkungan
3. Buat string tanda tangan berdasarkan metode yang diminta, URL, parameter, Isi, dan informasi lainnya, dan hitung tanda tangan permintaan
4. Tetapkan Authorization header permintaan

CatatanUntuk informasi selengkapnya tentang pembuatan skrip Tukang Pos, lihat Pembuatan Skrip di Tukang Pos.

variabel parameter

nama variabel	Apakah itu diperlukan?	menggambarkan	Komentar
mchid	Ya	Nomor pedagang
pedagang_serial_no	Ya	Nomor seri sertifikat sertifikat API pedagang
apiclient_key.pem	Ya	Kunci pribadi Merchant API dalam format PEM
openid	TIDAK	OpenID pengguna, {{openid}} dalam permintaan pengujian
aplikasi	TIDAK	AppID akun publik atau program mini
shangmi	TIDAK	Gunakan tanda tangan rahasia komersial bila nilainya true	Nilai defaultnya kosong, artinya menggunakan tanda tangan RSA
kunci pub.pem	Diperlukan bila penandatanganan dengan rahasia negara	Kunci publik Merchant API dalam format PEM	Jika PEM kunci privat berisi kunci publik, maka variabel ini tidak perlu diisi
server_url	TIDAK	Alamat server	Pengaturan defaultnya adalah https://api.mch.weixin.qq.com

Perpustakaan yang bergantung

Script menggunakan secara langsung:

• forge.min.js, PKI, RSA dan ASN.1 untuk menempa.
• sm2.js, tanda tangan SM2 dari perpustakaan rahasia nasional Tencent, TencentSM-javascript.

Untuk menghindari pengunduhan perpustakaan yang bergantung pada setiap permintaan, kedua perpustakaan disimpan dalam Variabel Koleksi sebagai kode sumber. Ini sangat mengurangi waktu yang dibutuhkan saat mengirim permintaan menggunakan Tukang Pos versi web.

Tindakan pencegahan keamanan

Kunci pribadi Merchant API adalah informasi yang sangat sensitif. Saat menggunakan kode ini, Anda harus mengingat hal-hal berikut:

• Atur visibilitas ruang kerja yang dikonfigurasi dengan kunci privat ke Personal atau Private , dan jangan setel ke Public .
• Jenis variabel kunci pribadi diatur ke secret . Nilai variabel ditampilkan di layar sebagai topeng.
• Nilai variabel kunci pribadi diatur dalam Current Value . Current Value hanya disimpan di Sesi lokal dan tidak akan dikirim ke server Tukang Pos.
• Jika Anda menggunakan skrip Postman dari orang lain, harap periksa pustaka, variabel, dan skrip dependen untuk memastikan semuanya belum dimodifikasi untuk menghindari penanaman kode yang tidak aman.

CatatanUntuk informasi tentang mekanisme keamanan Tukang Pos, silakan lihat Keamanan Tukang Pos.

Cara memulai permintaan rahasia negara

Gunakan templat parameter Pedagang Rahasia Nasional dan atur dalam variabel lingkungan:

• shangmi : Nilainya true .
• mchid : wajib, nomor pedagang.
• merchant_serial_no : wajib diisi, nomor seri sertifikat API merchant.
• apiclient_key.pem : Diperlukan, kunci pribadi API pedagang dalam format PEM.
• pubkey.pem : wajib, kunci publik rahasia nasional API pedagang dalam format PEM.

Dengan cara ini, skrip akan menggunakan SM2 rahasia nasional untuk menghitung tanda tangan dan mengirimkan permintaan rahasia nasional.

skrip impor lokal

Catatan: Tidak disarankan untuk mengimpor skrip secara lokal. Ini rumit dan rawan kesalahan serta tidak dapat menyinkronkan perubahan upstream.

Impor Koleksi Garpu memerlukan pendaftaran akun Tukang Pos. Jika tidak ingin mendaftar, Anda dapat mengimpor skrip secara lokal.

Pertama, buka koleksi WeChatPay APIv3, perluas opsi dan klik Ekspor:

Unduh dan simpan file wechatpay-apiv3.postman_collection.json secara lokal. Lalu, ada dua cara untuk mengimpor file JSON secara lokal:

• Tombol Import di sudut kiri atas antarmuka Tukang Pos
• Menu File > Import memulai impor

Pilih wechatpay-apiv3.postman_collection.json lokal dan klik Konfirmasi untuk menyelesaikan impor.

Anda akan menemukan serangkaian permintaan baru bernama "WeChatPay APIv3" telah ditambahkan ke Koleksi di meja kerja. Setelah mengonfigurasi Lingkungan, Anda dapat mengirimkan permintaan.

Sinkronkan perubahan hulu

Kami akan secara bertahap menambahkan antarmuka baru dan memperbarui antarmuka yang ada, namun cabang koleksi yang Anda fork ke meja kerja Anda tidak akan secara otomatis menyinkronkan perubahan upstream. Disarankan untuk watch Ruang Kerja Umum kami sehingga Anda akan menerima pemberitahuan dari tukang pos ketika ada perubahan hulu.

Saat ini, Anda dapat menggunakan pull changes untuk menarik perubahan hulu.

pull changes tukang pos mungkin memerlukan waktu untuk diselesaikan. Jika Anda menemui masalah, melakukan forking ulang juga merupakan ide bagus.

Pertanyaan Umum

Saat mengirim permintaan, pesan kesalahan "Kesalahan: Terlalu sedikit byte untuk menguraikan DER." atau "Terlalu sedikit byte untuk membaca nilai ASN.1."

Biasanya disebabkan oleh kesalahan pengisian variabel merchantPrivateKey yang dikonfigurasi di Lingkungan. Kunci pribadi yang diterima oleh skrip adalah string yang dimulai dengan -----BEGIN PRIVATEKEY----- dan diakhiri dengan -----END PRIVATE KEY----- .

Mengapa permintaan pengiriman saya sangat lambat?

Jika Anda menggunakan Postman versi web, silakan gunakan aplikasi Postman desktop. Karena keterbatasan berbagi sumber daya lintas asal (CORS) di browser, permintaan yang dikirim oleh versi web diteruskan oleh Tukang Pos di latar belakang.

Atau gunakan agen desktop Postman. Untuk informasi lebih lanjut, silakan merujuk ke blog terkait Postman.

Hubungi kami

Jika Anda memiliki pertanyaan, silakan kunjungi komunitas pengembang kami untuk mendapatkan masukan.

Kami juga menyambut segala jenis masalah dan Permintaan Penggabungan :-)