Payment Link generator adalah layanan yang disediakan oleh Espay Payment Gateway, memungkinkan Anda untuk mengirimkan tautan pembayaran kepada pelanggan. Anda dapat membuat link pembayaran (generate link) dan mempermudah proses pembayaran untuk pelanggan secara online.

Sebelum Integrasi

Pastikan Anda sudah menerima kredensial dari tim Espay.

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Payment Link Generator

1. Membuat Inquiry dan Payment

Anda diharuskan untuk menyediakan callback yang dapat diakses oleh Espay Payment Gateway. Pelajari lebih lanjut Inquiry dan Payment.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/paylink/paylink/generateurl
Production
https:///api-merchant.espay.id/paylink/paylink/generateurl
Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/x-www-form-urlencoded
Accept
*/*

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

Format:
yyyy-MM-dd hh:mi:ss

Contoh:
2024-03-14 07:49:28
comm_code
String (32)
Y
Merchant Code yang diberikan oleh tim Espay.

Contoh:
SGWYESSISHOP
merchant_key
String
Y
API Key yang diberikan oleh tim Espay.
user_id
String
Y
ID user.
user_name
String
Y
Nama user.
user_email
String
Y
Email user.
user_phone
String
Y
Nomor HP user.
order_id
String (32)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Format:
Alphanumeric (A-Z dan 0-9)

Contoh:
Nomor transaksi, invoice id, dll.
amount
String (17)
Y
Jumlah yang dibayarkan.

Contoh:
150000
expired
String(19)
Y
Waktu dan tanggal kedaluwarsa transaksi.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Contoh:
2026-08-30 13:21:02
return_uri
String (255)
Y
URL yang mengarahkan ke halaman merchant (callback).
device_id
String
O
ID device.
description
String
Y
Deskripsi
signature
String
Y
Kode yang digunakan untuk melakukan validasi transaksi.

Format:
$plain = uppercase(#signkey##rq_datetime##comm_code##user_id##PAYURL##) $signature = sha256 ($plain);
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (32)
Y
Tanggal dan waktu transaksi yang dikirim dari server Espay.

Format:
yyyy-MM-dd hh:mi:ss

Contoh:
2024-03-14 07:49:28
error_code
String (4)
Y
Kode respons.
error_desc
String (32)
Y
Deskripsi respons.
comm_code
String(32)
Y
Merchant Code yang diberikan oleh tim Espay.

Contoh:
SGWYESSISHOP
user_id
String
Y
ID user.
order_id
String(32)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Format:
Alphanumeric (A-Z dan 0-9)

Contoh:
Nomor transaksi, invoice id, dll.
description
String (32)
Y
Deskripsi transaksi.
expired
String (19)
Y
Waktu dan tanggal kedaluwarsa transaksi.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Contoh:
2026-08-30 13:21:02
device_id
String
O
ID device.
payment_url
String
Y
URL untuk mengarahkan ke halaman pembayaran.
Y: Yes, O: Optional, C: Conditional
3. Setelah Pembayaran
Espay Payment Gateway menyediakan API Opsional yang dapat Anda gunakan untuk mendukung kebutuhan pembayaran lainnya.




































Sample Headers

POST /paylink/paylink/generateurl HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Cookie: sl-session=PPombr8NZGqv2bKh7TT9Bg==
Content-Length: 369





Sample Request

https://sandbox-api.espay.id/paylink/paylink/generateurl
rq_uuid:321312312
rq_datetime:2024-01-01 15:21:02
comm_code:SGWYESSISHOP
merchant_key:1edf391a59acb5ac8851db39d1e4f5bc
user_id:123
user_name:GILANG
user_email:[email protected]
user_phone:628855222389
order_id:12345
amount:15000
expired:2024-12-30 13:21:02
return_uri:https://google.com
device_id:123123
description:pembayaran belanja
signature:d4787b96b6ee30036e42cf54bbf346559a8200feb0ce81a1df74231759990e31























































Sample Positive Response

{
    "rq_uuid": "O20260724001",
    "rs_datetime": "2026-07-24 10:37:40",
    "error_code": "0000",
    "error_desc": "Success",
    "comm_code": "SGWYESSISHOP",
    "user_id": "123",
    "order_id": "20260724001",
    "description": "pembayaran belanja",
    "expired": "2026-12-30 13:21:02",
    "payment_url": "https://sandbox-kit.espay.id/paylink/index/pay/?token=MDZmODJjZjEzMmIyYjFmMDAwZTEwN2EwZDk4MmEyYTEyZDE4ZjJhYTAxNjA3ZmIzMDhhODAyZTNlMmNkMTI2NA=="
}


HTTP

POST /paylink/paylink/generateurl HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Cookie: sl-session=PPombr8NZGqv2bKh7TT9Bg==
Content-Length: 369

rq_uuid=321312312&rq_datetime=2024-01-01%2015%3A21%3A02&comm_code=SGWYESSISHOP&merchant_key=1edf391a59acb5ac8851db39d1e4f5bc&user_id=123&user_name=GILANG&user_email=uatbca3%40skybr.id&user_phone=628855222389&order_id=12345&amount=15000&expired=2024-12-30%2013%3A21%3A02&return_uri=https%3A%2F%2Fgoogle.com&device_id=123123&description=pembayaran%20belanja&signature=d4787b96b6ee30036e42cf54bbf346559a8200feb0ce81a1df74231759990e31


CURL

curl --location 'https://sandbox-api.espay.id/paylink/paylink/generateurl' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: sl-session=PPombr8NZGqv2bKh7TT9Bg==' \
--data-urlencode 'rq_uuid=321312312' \
--data-urlencode 'rq_datetime=2024-01-01 15:21:02' \
--data-urlencode 'comm_code=SGWYESSISHOP' \
--data-urlencode 'merchant_key=1edf391a59acb5ac8851db39d1e4f5bc' \
--data-urlencode 'user_id=123' \
--data-urlencode 'user_name=GILANG' \
--data-urlencode '[email protected]' \
--data-urlencode 'user_phone=628855222389' \
--data-urlencode 'order_id=12345' \
--data-urlencode 'amount=15000' \
--data-urlencode 'expired=2024-12-30 13:21:02' \
--data-urlencode 'return_uri=https://google.com' \
--data-urlencode 'device_id=123123' \
--data-urlencode 'description=pembayaran belanja' \
--data-urlencode 'signature=d4787b96b6ee30036e42cf54bbf346559a8200feb0ce81a1df74231759990e31'
Scroll to Top