Direct API

Create VA

Virtual Account adalah nomor rekening unik yang dihasilkan secara elektronik oleh bank atau penyedia layanan pembayaran, seperti Espay Payment Gateway. Virtual Account ini dirancang untuk memfasilitasi transaksi pembayaran dengan cara yang lebih mudah dan terorganisir.

Sebelum Integrasi

Pastikan Anda sudah menerima kredensial dari tim Espay.

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Direct API – Virtual Account.

1. Menampilkan metode pembayaran

Inquiry Merchant Info adalah layanan yang dapat Anda gunakan untuk mengetahui kode bank dan produk yang aktif. Dengan layanan ini, Anda dapat menyesuaikan antarmuka pengguna (UI) saat memilih metode pembayaran. Pelajari Inquiry Merchant Info

2. Membuat Inquiry dan Payment

Anda diharuskan untuk menyediakan callback yang dapat diakses oleh Espay Payment Gateway. Pelajari lebih lanjut Inquiry (Virtual Account Dinamis) dan Payment.

3. Membuat Virtual Account
Tipe Value
Kode Layanan
27
Nama
API Virtual Account - Create VA
HTTP Method
POST

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/api-mava/v1.0/transfer-va/create-va
Production
https://api.espay.id/api-mava/v1.0/transfer-va/create-va
Nama Tipe Mandatory Keterangan
Content-Type
String
Y
Isi konten permintaan Anda.

Contoh:
application/json
X-TIMESTAMP
String (25)
Y
Tanggal dan waktu lokal customer.

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

Contoh:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Payment Gateway | Asymmetric Signature
X-EXTERNAL-ID
String (32)
Y
String Numerik. Kode referensi yang bersifat unik pada hari yang sama.
X-PARTNER-ID
String (50)
Y
Merchant code yang diberikan oleh tim Espay.
CHANNEL-ID
String (5)
Y
Kode channel.

Value:
ESPAY
Authorization-Customer
String (150)
C
Kode token B2B2C. Khusus Espay -> Bank.

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
partnerServiceId
String (8)
...
Kode partner.

Format:
padding space + ESPAY

Value:
" ESPAY"
customerNo
String (20)
...
Merchant code yang diberikan oleh tim Espay.
virtualAccountNo
String (28)
...
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
virtualAccountName
String (255)
...
Nama customer.
virtualAccountEmail
String (255)
...
Email customer. Khusus pembayaran paylater.
virtualAccountPhone
String (30)
...
Nomor telepon customer. Khusus pembayaran paylater.

Format:
62xxxxxxxxx
trxId
String (64)
...
...
totalAmount
Object
...
  value
String (16.2)
...
Jumlah yang dibayarkan.

Format:
Desimal .00 (ISO 4217)

Contoh:
150000.00
  currency
String (3)
...
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
additionalInfo
  bankCode
...
...
Kode bank. Lihat daftar kode bank di sini.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respons. Lihat kode respons di sini.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+27+00 = 2002700.
responseMessage
String (150)
Y
Deskripsi respons. Lihat deskripsi respons di sini.
virtualAccountData
Object
Y
  partnerServiceId
String (8)
Y
Kode partner.

Format:
padding space + ESPAY

Value:
" ESPAY"
  customerNo
String (20)
Y
Merchant code yang diberikan oleh tim Espay.

Contoh:
SGWYESSISHOP
  virtualAccountNo
String (28)
Y
Kode unik untuk mengidentifikasi pesanan / penagihan / faktur.

Contoh:
Nomor transaksi, invoice id, dll.
  virtualAccountName
String (255)
Y
Nama customer.
  virtualAccountPhone
String (30)
C
Nomor telepon customer. Khusus pembayaran paylater.

Format:
62xxxxxxxxx
  virtualAccountEmail
String (255)
C
Email customer. Khusus pembayaran paylater.
  expiredDate
String (25)
...
Waktu kedaluwarsa virtual account.

Format:
YYYY-MM-DDThh:mm:ss (ISO 8601)
  totalAmount
Object
    value
String (16.2)
...
Jumlah yang dibayarkan.

Format:
Desimal.00 (ISO 4217)

Value:
155000.00
    currency
String (3)
...
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
  feeAmount
Object
    value
String (16.2)
...
Biaya transaksi.

Format:
Desimal.00 (ISO 4217)

Value:
155000.00
    currency
String (3)
...
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
Y: Yes, O: Optional, C: Conditional
5. Setelah Pembayaran
Espay Payment Gateway menyediakan API Opsional yang dapat Anda gunakan untuk mendukung kebutuhan pembayaran lainnya.

Try It!

Anda bisa coba masukkan data sesuai dengan input yang telah disediakan. Setelah itu Anda submit dan lihat hasilnya!











































































































Sample Headers

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:SHwb9RwkUyxTV8uLv1MoGShUgZi1Of35GtB9GVmouSt2r8ePf7Sy3zBuuBaUOhMcWJnojFtOuRhVR64uAES8H8R91kvAhW29l3QU9WO3LFDSp4PI8vwQVeHXOXlnNZa+HLXP8iYqnXRCIsoSTPTRQiBzpjQaUB1nGtEBEnDCMhRG7ijnMRtJQGiWUq2uT2Kfs23i64F8A2sVTojgnB4oPFMaeGuy0vhmtQqKAezBlKI9xhRAQz8cVHo1qcNNtakQjuWIS0065lL0bDuY7SBY6iMTFzfGZkaxt8pzNLHbs4SbyjvzZnXt8of0ZUwEQxrMg5CLeACE8Tp7cyrgQ93w==
X-EXTERNAL-ID:d41e58d9-0e1d-4632-a9c1-df0eea578c0c
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY


























Sample Request

{
    "partnerServiceId": " ESPAY",
    "customerNo": "SGWYESSISHOP",
    "virtualAccountNo": "10110009568",
    "virtualAccountName": "YESSI SHOP",
    "virtualAccountEmail": "[email protected]",
    "virtualAccountPhone": "62821389343691",
    "trxId": "250609-0000001",
    "totalAmount": {
        "value": "15000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "bankCode": "157"
    }
}



































Sample Positive Response

{
    "responseCode": "2002700",
    "responseMessage": "Success",
    "virtualAccountData": {
        "partnerServiceId": "   ESPAY",
        "customerNo": "SGWYESSISHOP",
        "virtualAccountNo": "01798123480009568",
        "virtualAccountName": "YESSI SHOP",
        "virtualAccountPhone": "62821389343691",
        "virtualAccountEmail": "[email protected]",
        "expiredDate": "",
        "totalAmount": {
            "value": "15000.00",
            "currency": "IDR"
        },
        "feeAmount": {
            "value": "3500.00",
            "currency": "IDR"
        }
    }
}


Sample Negative Response

{
    "responseCode": "5002701",
    "responseMessage": "Mapping sender service. Sender id is empty"
}


HTTP

POST /api-mava/v1.0/transfer-va/create-va HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/json
X-TIMESTAMP: 2024-03-14T07:49:28+07:00
X-SIGNATURE: SHwb9RwkUyxTV8uLv1MoGShUgZi1Of35GtB9GVmouSt2r8ePf7Sy3zBuuBaUOhMcWJnojFtOuRhVR64uAES8H8R91kvAhW29l3QU9WO3LFDSp4PI8vwQVeHXOXlnNZa+HLXP8iYqnXRCIsoSTPTRQiBzpjQaUB1nGtEBEnDCMhRG7ijnMRtJQGiWUq2uT2Kfs23i64F8A2sVTojgnB4oPFMaeGuy0vhmtQqKAezBlKI9xhRAQz8cVHo1qcNNtakQjuWIS0065lL0bDuY7SBY6iMTFzfGZkaxt8pzNLHbs4SbyjvzZnXt8of0ZUwEQxrMg5CLeACE8Tp7cyrgQ93w==
X-EXTERNAL-ID: d41e58d9-0e1d-4632-a9c1-df0eea578c0c
X-PARTNER-ID: SGWYESSISHOP
CHANNEL-ID: ESPAY

{
        "partnerServiceId": " ESPAY",
        "customerNo": "SGWYESSISHOP",
        "virtualAccountNo": "10110009568",
        "virtualAccountName": "YESSI SHOP",
        "virtualAccountEmail": "[email protected]",
        "virtualAccountPhone": "62821389343691",
        "trxId": "250609001",
        "totalAmount": {
                "value": "15000.00",
                "currency": "IDR"
        },
        "additionalInfo": {
                "bankCode": "157"
        }
}


CURL

curl --location 'https://sandbox-api.espay.id/api-mava/v1.0/transfer-va/create-va' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: SHwb9RwkUyxTV8uLv1MoGShUgZi1Of35GtB9GVmouSt2r8ePf7Sy3zBuuBaUOhMcWJnojFtOuRhVR64uAES8H8R91kvAhW29l3QU9WO3LFDSp4PI8vwQVeHXOXlnNZa+HLXP8iYqnXRCIsoSTPTRQiBzpjQaUB1nGtEBEnDCMhRG7ijnMRtJQGiWUq2uT2Kfs23i64F8A2sVTojgnB4oPFMaeGuy0vhmtQqKAezBlKI9xhRAQz8cVHo1qcNNtakQjuWIS0065lL0bDuY7SBY6iMTFzfGZkaxt8pzNLHbs4SbyjvzZnXt8of0ZUwEQxrMg5CLeACE8Tp7cyrgQ93w==' \
--header 'X-EXTERNAL-ID: d41e58d9-0e1d-4632-a9c1-df0eea578c0c' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--data-raw '{
        "partnerServiceId": " ESPAY",
        "customerNo": "SGWYESSISHOP",
        "virtualAccountNo": "10110009568",
        "virtualAccountName": "YESSI SHOP",
        "virtualAccountEmail": "[email protected]",
        "virtualAccountPhone": "62821389343691",
        "trxId": "250609001",
        "totalAmount": {
                "value": "15000.00",
                "currency": "IDR"
        },
        "additionalInfo": {
                "bankCode": "157"
        }
}'
Scroll to Top