2020-02-01

Cek Status Pembayaran (Money-in read permission)

Endpoint: Cek Status Pembayaran Ewallet

GET https://api.xendit.co/ewallets?external_id={external_id}&ewallet_type={ewallet_type}

Endpoint ini digunakan untuk mengecek status dari sebuah pembayaran. Anda perlu memasukkan external_id dan ewallet_type.

Parameter Request (Money-in read permission)

Contoh: Request Cek Status Pembayaran Ewallet

OVO, DANA, LINKAJA

curl 'https://api.xendit.co/ewallets?external_id=ovo-ewallet&ewallet_type=OVO' \
   -X GET \
   -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg:

<?php

  use Xendit\Xendit;
  require 'vendor/autoload.php';

  Xendit::setApiKey('xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==');

  $external_id = 'ovo-payment';
  $ewallet_type = 'OVO';
  $getPayments = \Xendit\EWallets::getPaymentStatus($external_id, $ewallet_type);
  var_dump($getPayments);

?>

const x = new require('xendit-node')({ secretKey: 'xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==' });

const { EWallet } = x;
const ewalletSpecificOptions = {};
const ew = new EWallet(ewalletSpecificOptions);

const resp = await ew.getPayment({
  externalID: 'ovo-ewallet',
  ewalletType: EWallet.Type.OVO,
});
console.log(resp);

Xendit.apiKey = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==";
try {
  EWalletPayment payment = EWalletPayment.getPaymentStatus("ovo-ewallet", EWalletPayment.EWalletType.OVO);    
} catch (XenditException e) {
  e.printStackTrace();
}

xendit.Opt.SecretKey = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw=="

data := ewallet.GetPaymentStatusParams{
  ExternalID:  "ovo-payment",
  EWalletType: xendit.EWalletTypeDANA,
}

resp, err := ewallet.GetPaymentStatus(&data)
if err != nil {
  log.Fatal(err)
}

fmt.Printf("retrieved payment: %+v\n", resp)

from xendit import Xendit, EWalletType

api_key = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw=="
xendit_instance = Xendit(api_key=api_key)
EWallet = xendit_instance.EWallet

ovo_payment_status = EWallet.get_payment_status(
    ewallet_type=EWalletType.OVO,
    external_id="ovo-ewallet-testing-id-1234",
)
print(ovo_payment_status)

string apiKey = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==";

XenditClient xendit = new XenditClient(apiKey);
EWalletPaymentClient eWalletPayment = xendit.EWalletPayment;

EWalletPaymentResponse eWalletPaymentResponse = await eWalletPayment.Get("ovo-ewallet-testing-id-1234", EWalletEnum.PaymentType.Ovo);

Parameter Header	Tipe	Deskripsi
for-user-id optional	string	User-id yang Anda inginkan untuk membuat transaksi. Header ini hanya bisa digunakan jika Anda memiliki akses ke xenPlatform. Silahkan buka xenPlatform untuk informasi lebih lanjut.

Parameter Query	Tipe	Deskripsi
external_id required	string	ID yang merupakan identifikasi unik dari sistem Anda seperti nomor ponsel, surat elektronik atau ID transaksi. Panjang maksimum yang diperbolehkan adalah 1000 karakter.
ewallet_type required	string	Tipe dari eWallet yang akan digunakan. Harus dalam huruf kapital. Tipe eWallet yang tersedia: 'OVO', 'DANA', 'LINKAJA'

Contoh: Respon Sukses dari Cek Status Pembayaran

Status pada Respon OVO

OVO

{
  "amount": 10000,
  "business_id": "5850eteStin791bd40096364",
  "ewallet_type": "OVO",
  "external_id": "ovo-payment",
  "status": "COMPLETED",
  "transaction_date": "2020-01-14T11:48:47.903Z"
}

Status	Deskripsi
COMPLETED	Transaksi pembayaran untuk external_id yang ditentukan berhasil
PENDING	Transaksi pembayaran untuk external_id yang ditentukan sedang menunggu persetujuan dari pengguna OVO
FAILED	Transaksi pembayaran untuk external_id yang ditentukan gagal dan tidak diselesaikan (contoh: pengguna tidak menyetujui pembayaran atau sesi pembayaran telah berakhir)

Status pada Respon DANA

DANA

{
  "amount": 10000,
  "business_id": "5850eteStin791bd40096364",
  "checkout_url": "https://example.com/checkout",
  "external_id": "dana-payment-23",
  "expiration_date": "2020-03-20T04:54:10+07:00",
  "status": "PAID"
}

Status	Deskripsi
PAID	Transaksi pembayaran untuk external_id yang ditentukan berhasil
PENDING	Transaksi pembayaran untuk external_id yang ditentukan sedang menunggu persetujuan dari pengguna DANA
FAILED	Pembuatan pembayaran dengan DANA untuk external_id yang ditentukan gagal
EXPIRED	URL transaksi pembayaran untuk external_id yang ditentukan telah kadaluarsa (pengguna tidak mengakses link pembayaran atau menyelesaikan proses pembayaran)

Status pada Respon LinkAja

LINKAJA - COMPLETED or FAILED

{
  "amount": 10000,
  "business_id": "5850eteStin791bd40096364",
  "external_id": "linkaja-payment-23",
  "payment_timestamp": "2020-01-14T11:48:47.903Z",
  "status": "COMPLETED"
}

LINKAJA - PENDING or EXPIRED

{
  "amount": 10000,
  "business_id": "5850eteStin791bd40096364",
  "checkout_url": "https://example.com/checkout",
  "expired_at": "2020-01-14T11:48:47.903Z",
  "external_id": "linkaja-payment-23",
  "status": "PENDING"
}

Status	Deskripsi
COMPLETED	Transaksi pembayaran untuk external_id yang ditentukan berhasil
PENDING	Transaksi pembayaran untuk external_id yang ditentukan sedang menunggu persetujuan dari pengguna LinkAja
FAILED	Pembuatan pembayaran dengan LinkAja untuk external_id yang ditentukan gagal
EXPIRED	URL transaksi pembayaran untuk external_id yang ditentukan telah kadaluarsa (pengguna tidak mengakses link pembayaran atau menyelesaikan proses pembayaran)

Kode Error

Contoh: Respon Gagal dari Cek Status Pembayaran

{
  "error_code": "PAYMENT_NOT_FOUND_ERROR",
  "message": "Payment not found",
}

Kode Error	Deskripsi
PAYMENT_NOT_FOUND_ERROR 404	Pembayaran tidak ditemukan
REQUEST_FORBIDDEN_ERROR 403	API key yang digunakan tidak memiliki izin untuk melakukan request. Mohon berikan izin yang sesuai terhadap API key yang digunakan. Pelajari lebih lanjut disini