qris-payment 1.1.0

Package Python untuk generate QRIS dan cek status pembayaran

QRIS Payment Python Package

Package Python untuk generate QRIS dan cek status pembayaran.

Fitur

• Generate QRIS dengan nominal tertentu
• Tambah logo di tengah QR
• Cek status pembayaran
• Validasi format QRIS
• Perhitungan checksum CRC16

Instalasi

pip install qris-payment

Penggunaan

Inisialisasi

from qris_payment import QRISPayment

config = {
    'merchantId': 'YOUR_MERCHANT_ID',
    'auth_username': 'YOUR_AUTH_USERNAME',
    'auth_token': 'YOUR_AUTH_TOKEN',
    'base_qr_string': 'YOUR_BASE_QR_STRING',
    'logo_path': 'path/to/logo.png'  # Opsional
}

qris = QRISPayment(config)

Generate QRIS

def generate_qr():
    try:
        result = qris.generate_qr(10000)
        
        # Simpan QR ke file
        result['qr_image'].save('qr.png')
        print('QR String:', result['qr_string'])
    except Exception as e:
        print(f"Error: {str(e)}")

Cek Status Pembayaran

def check_payment():
    try:
        result = qris.check_payment('REF123', 10000)
        print('Status pembayaran:', result)
    except Exception as e:
        print(f"Error: {str(e)}")

Konfigurasi

Parameter	Tipe	Deskripsi	Wajib
merchantId	string	ID Merchant QRIS	Ya
auth_username	string	Username untuk autentikasi API	Ya
auth_token	string	Token untuk autentikasi API	Ya
base_qr_string	string	String dasar QRIS	Ya
logo_path	string	Path ke file logo (opsional)	Tidak

Response

Generate QR

{
    'qr_string': "000201010212...",  # String QRIS
    'qr_image': <PIL.Image.Image>  # Objek gambar QR
}

Cek Pembayaran

{
    'success': True,
    'data': {
        'status': 'PAID' | 'UNPAID',
        'amount': int,
        'reference': str,
        'date': str,  # Hanya jika status PAID
        'brand_name': str,  # Hanya jika status PAID
        'buyer_reff': str  # Hanya jika status PAID
    }
}

Error Handling

Package ini akan melempar exception dengan pesan yang jelas jika terjadi masalah:

• Format QRIS tidak valid
• Gagal generate QR
• Gagal cek status pembayaran
• Merchant ID tidak valid
• Auth username atau token tidak valid
• dll

Contoh Lengkap

from qris_payment import QRISPayment

config = {
    'merchantId': 'YOUR_MERCHANT_ID',
    'auth_username': 'YOUR_AUTH_USERNAME',
    'auth_token': 'YOUR_AUTH_TOKEN',
    'base_qr_string': 'YOUR_BASE_QR_STRING',
    'logo_path': 'path/to/logo.png'
}

qris = QRISPayment(config)

def main():
    try:
        # Generate QR
        result = qris.generate_qr(10000)
        result['qr_image'].save('qr.png')
        print('QR String:', result['qr_string'])

        # Cek pembayaran
        payment_result = qris.check_payment('REF123', 10000)
        print('Status pembayaran:', payment_result)
    except Exception as e:
        print(f"Error: {str(e)}")

if __name__ == "__main__":
    main()

Persyaratan Sistem

• Python >= 3.6
• Dependencies:
  • qrcode >= 7.4.2
  • Pillow >= 9.0.0
  • requests >= 2.28.0

Lisensi

MIT

Kontribusi

Silakan buat pull request untuk kontribusi. Untuk perubahan besar, buka issue terlebih dahulu untuk mendiskusikan perubahan yang diinginkan.

Support

Jika menemukan masalah atau memiliki pertanyaan, silakan buka issue di repository ini.