> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.yukbayarin.asia/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.yukbayarin.asia/_mcp/server.

# Gambaran Umum API

Selamat datang di referensi API YukBayarin. Di sini Anda akan menemukan semua informasi yang Anda butuhkan untuk menggunakan API YukBayarin.

## Autentikasi

Setiap request ke Service API wajib menyertakan `client_id`, `x-username`, `x-timestamp` dan `x-signature` di header request. Berikut adalah detail **Autentikasi Header** yang diperlukan:

---

## Environments

YukBayarin menyediakan dua mode Environments: sandbox mode untuk pengembangan dan Live Mode untuk mengaktifkan integrasi YukBayarin Anda.

---

## Rate Limits

Untuk keamanan dan pencegahan penipuan, YukBayarin menerapkan rate limit di request

> **Note**
>
> YukBayarin berhak untuk mengubah rate limit jika terdapat masalah keamanan, dan akan mengkomunikasikan perubahan tersebut kepada akun yang terdampak.

### Request Limits

YukBayarin menerapkan batasan kecepatan permintaan untuk memberikan kinerja sistem, keamanan, dan penggunaan yang adil secara optimal. Batasan permintaan mengatur jumlah permintaan yang dapat dilakukan oleh satu token API ke endpoint dalam periode waktu tertentu. Hubungi tim YukBayarin jika Anda memiliki kasus penggunaan yang memerlukan perubahan batasan.

| Jumlah Permintaan | Periode |
| :---------------- | :------ |
| **100**           | Menit   |

### Kontrol Penipuan (Fraud Controls)

Kontrol pencegahan penipuan, yang juga dikenal sebagai batasan transaksi, menentukan jumlah penolakan dan transaksi yang dapat diproses oleh titik pembayaran (paypoint) dalam periode waktu tertentu.

Hubungi tim YukBayarin untuk menyesuaikan batas transaksi untuk masing-masing titik pembayaran.

| Deskripsi                                             | Batas Default |
| :---------------------------------------------------- | :------------ |
| Jumlah maksimum penolakan per kartu, per jam          | 3             |
| Jumlah maksimum penolakan per alamat IP, per jam      | 3             |
| Jumlah maksimum penolakan per paypoint, per jam       | 10            |
| Jumlah maksimum penolakan per pembayar, per jam       | 3             |
| Jumlah maksimum transaksi per paypoint dalam 15 menit | 250           |
| Jumlah maksimum transaksi per kartu per jam           | 10            |

---