Berikut adalah langkah-langkah cara membuat Paylater melalui API dalam mode live:
1. Membuat secret API Key melalui dashboard Anda dalam mode test
Referensi dapat dilihat di doc berikut.
2. Masukkan callback URL Anda pada Dashboard - Settings - Callbacks di bagian Paylater Payment Status dan pastikan saat klik "test and save" respon mengembalikan 2XX
3. Membuat Customer menggunakan endpoint:
POST https://api.xendit.co/customers
4. Masukkan secret API key Anda pada Authorization
5. Pada Body request, Anda dapat menggunakan parameter dibawah sebagai contoh:
{
"given_names": "Yoselin",
"surname":"Gunawan",
"email": "yoselin@xendit.co",
"mobile_number": "+6281388089105",
"reference_id": "yoselinpaylater123",
"addresses": [{
"street_line1": "Jalan Makan",
"city": "Jakarta Pusat",
"province": "Daerah Khusus Ibukota Jakarta",
"postal_code": "12160",
"country": "ID"
}]
}
6. Klik send dan Anda akan mendapatkan respons berikut:
{
"id": "6fe639e6-144d-4ff4-be10-2a7cf787369b",
"reference_id": "yoselinpaylater123",
"given_names": "Yoselin",
"email": "yoselin@xendit.co",
"mobile_number": "+6281388089105",
"description": null,
"middle_name": null,
"surname": "Gunawan",
"phone_number": null,
"hashed_phone_number": null,
"nationality": null,
"date_of_birth": null,
"metadata": null,
"employment": null,
"addresses": [
{
"category": null,
"country": "ID",
"state": null,
"province": "Daerah Khusus Ibukota Jakarta",
"city": "Jakarta Pusat",
"postal_code": "12160",
"street_line1": "Jalan Makan",
"street_line2": null,
"is_preferred": false
}
]
}
7. Membuat Paylater Plan menggunakan endpoint:
POST https://api.xendit.co/paylater/plans
8. Masukkan secret API key Anda pada Authorization
9. Pada Body request, Anda dapat menggunakan parameter dibawah, mohon untuk masukan customer_id dari response sebelumnya di body request berikut (pada bagian bold):
{
"customer_id": "6fe639e6-144d-4ff4-be10-2a7cf787369b",
"channel_code": "ID_KREDIVO",
"currency": "IDR",
"amount": 1000,
"order_items": [{
"type": "PHYSICAL_PRODUCT",
"reference_id": "SKU_backtoschool-promotion123",
"name": "Nymbus twothousand",
"net_unit_amount": 1000,
"quantity": 1,
"url": "https://www.zngmyhome.com/nymbus",
"category": "Sports",
"subcategory": "Equipment",
"description": "Sports equipment for quidditch"
}]
}
- Mohon pastikan bahwa "amount" sesuai dengan "net_unit_amount" dikali "quantity" (1000 x 1 = 1000)
- Mohon untuk diingat bahwa Paylater Plan tidak menentukan tenor/installment yang harus dibayarkan customer Anda, dikarenakan tenor/installment ditentukan oleh partner masing-masing Paylater pada account Paylater-nya.
10. Klik send dan Anda akan mendapatkan respons berikut::
{
"id": "plp_a4866b2a-08b4-4c6c-a432-7c8bf3f7d2af",
"customer_id": "6fe639e6-144d-4ff4-be10-2a7cf787369b",
"channel_code": "ID_KREDIVO",
"currency": "IDR",
"amount": 1000,
"order_items": [
{
"type": "PHYSICAL_PRODUCT",
"reference_id": "SKU_backtoschool-promotion123",
"name": "Nymbus twothousand",
"net_unit_amount": 1000,
"quantity": 1,
"url": "https://www.zngmyhome.com/nymbus",
"category": "Sports",
"subcategory": "Equipment",
"description": "Sports equipment for quidditch",
"metadata": null
}
],
"options": [
{
"total_amount": 2000,
"installment_amount": 2000,
"interval": "MONTH",
"interval_count": 1,
"total_recurrence": 1,
"interest_rate": 0,
"description": "Bayar dalam 30 hari"
}
],
"created": "2023-04-04T04:29:05.014Z"
}
11. Membuat PayLater charge menggunakan endpoint:
12. Masukkan secret API key Anda pada Authorization
13. Pada Body request, Anda dapat menggunakan parameter dibawah, mohon untuk masukan plan_id dari response sebelumnya di body request berikut (pada bagian bold):
{
"plan_id": "plp_a4866b2a-08b4-4c6c-a432-7c8bf3f7d2af",
"reference_id": "order_id_test1234",
"checkout_method": "ONE_TIME_PAYMENT",
"success_redirect_url": "https://google.com",
"failure_redirect_url": "https://twitter.com"
}
14. Klik send dan Anda akan mendapatkan respons berikut:
{
"id": "plc_b907ce2b-6817-483a-86e3-fdc8c9c01b21",
"business_id": "603f1c4172bbe840979fd408",
"reference_id": "order_id_test1234",
"customer_id": "6fe639e6-144d-4ff4-be10-2a7cf787369b",
"plan_id": "plp_a4866b2a-08b4-4c6c-a432-7c8bf3f7d2af",
"currency": "IDR",
"amount": 1000,
"channel_code": "ID_KREDIVO",
"checkout_method": "ONE_TIME_PAYMENT",
"status": "PENDING",
"actions": {
"desktop_web_checkout_url": "https://pay.kredivo.com/signIn?tk=06e528b0-565e-414e-a9b1-9561f7209c10",
"mobile_web_checkout_url": "https://pay.kredivo.com/signIn?tk=06e528b0-565e-414e-a9b1-9561f7209c10"
},
"expires_at": "2023-04-05T04:33:35.299Z",
"success_redirect_url": "https://google.com",
"failure_redirect_url": "https://twitter.com",
"callback_url": "https://8b6d6f2961b98dc36e327335023ece5d.m.pipedream.net/hook",
"created": "2023-04-04T04:33:35.303Z",
"updated": "2023-04-04T04:33:35.470Z",
"order_items": [
{
"type": "PHYSICAL_PRODUCT",
"reference_id": "SKU_backtoschool-promotion123",
"name": "Nymbus twothousand",
"net_unit_amount": 1000,
"quantity": 1,
"url": "https://www.zngmyhome.com/nymbus",
"category": "Sports",
"subcategory": "Equipment",
"description": "Sports equipment for quidditch",
"metadata": null
}
],
"voided_at": null,
"payment_method_id": null,
"metadata": null
}
15. Klik link dibawah "action" untuk melanjutkan pembayaran dan login ke Paylater app/webpage:
16. Lanjutkan pembayaran pada page Paylater partner:
17. Masukan OTP yang dikirimkan dari partner untuk pembayaran:
18. Transaksi akan diproses dalam beberapa waktu dan partner akan informasikan bahwa pembayaran sudah sukses kemudian Anda akan diarahkan ke "success_redirect_url" yang sudah Anda set dan transaksi akan muncul pada Transactions Tab:
Dan simulasi pembayaran Paylater pada live mode sudah selesai! Terkait API reference silakan klik link berikut.