Langsung ke konten utama
POST
Autentikasi adalah fitur baru. Endpoint-endpoint ini dilayani oleh penerbit aplikasi Anda, seperti https://<name>.auth.didit.me, dan tidak pernah menggunakan kunci API Didit Anda.
Parameter query step_up dan status pada return_to Anda hanya memberi tahu aplikasi Anda untuk memeriksa. Sebelum bertindak, baca step-up dengan Dapatkan step-up dan lanjutkan hanya jika status bernilai approved.

Otorisasi

Authorization
string
header
wajib

Token akses orang tersebut dari POST /token/: JWT ES256 dengan header typ: at+jwt, berlaku paling lama 5 menit. Bukan kunci API Didit Anda.

Body

application/json

Tindakan sensitif yang akan diambil orang tersebut.

action
enum<string>
wajib

payout (penarikan atau transfer dana), bank (menambahkan atau mengubah rekening bank) atau contact (mengubah email atau nomor telepon). Payout juga menerapkan aturan perangkat baru.

Opsi yang tersedia:
payout,
bank,
contact
return_to
string
wajib

Tujuan pengguna kembali setelah memverifikasi, dengan tambahan step_up=<id>&status=approved. Saat suatu aturan berlaku, nilai ini harus merupakan salah satu URI pengalihan aplikasi; saat tidak ada yang berlaku, nilai ini tidak diperiksa.

Maximum string length: 2048
Contoh:

"https://app.example.com/payouts/confirm"

amount
string

Wajib untuk payout: jumlah, hingga dua desimal. Angka JSON juga diterima.

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
Contoh:

"900.00"

currency
string

Kode ISO 4217 dari amount. Default ke mata uang aturan pembayaran; pembayaran dalam mata uang lain selalu diperiksa.

Pattern: ^[A-Z]{3}$
Contoh:

"USD"

Respons

Tidak ada aturan yang berlaku.

Tidak ada aturan yang berlaku: lanjutkan tindakan.

required
enum<boolean>
wajib
Opsi yang tersedia:
false
Terakhir diubah pada 7 November 2026