Pengembalian dana

post

https://api.cryptomus.com/v1/payment/refund

Menyalin

Meminta

Parameter kueri

Nama	Jenis parameter	Definisi
address*	string	Alamat tempat pengembalian dana harus dilakukan
is_subtract*	boolean	Apakah akan mengambil komisi dari saldo pedagang atau dari jumlah pengembalian danabenar - ambil komisi dari saldo pedagangsalah - kurangi jumlah yang dapat dikembalikan dengan jumlah komisi
uuid*	uuidrequired_without: order_id	Faktur uuid
order_id*	stringmin:1max:128alpha_dashrequired_without: uuid	ID pesanan faktur

Jenis parameter

string

Definisi

Alamat tempat pengembalian dana harus dilakukan

Jenis parameter

boolean

Definisi

Apakah akan mengambil komisi dari saldo pedagang atau dari jumlah pengembalian danabenar - ambil komisi dari saldo pedagangsalah - kurangi jumlah yang dapat dikembalikan dengan jumlah komisi

Jenis parameter

uuidrequired_without: order_id

Definisi

Faktur uuid

Jenis parameter

stringmin:1max:128alpha_dashrequired_without: uuid

Definisi

ID pesanan faktur

* - parameter wajib

Faktur diidentifikasi oleh order_id atau uuid, jika Anda melewati keduanya, akun akan diidentifikasi oleh uuid

Contoh permintaan


curl https://api.cryptomus.com/v1/payment/refund \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
            "uuid": "8b03432e-385b-4670-8d06-064591096795",
            "address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm", 
            "is_subtract": "true"
        }'

Menyalin

Tanggapan

Contoh respons


1{
2  "state": 0,
3  "result": []
4}

Menyalin

Kemungkinan kesalahan

Kesalahan validasi

kode : 422

contoh tanggapan:

Jika faktur dengan uuid atau order_id yang Anda berikan tidak ada:


1{
2    "state": 1,
3    "message": "Payment was not found"
4}

Menyalin

Jika Anda tidak meneruskan uuid dan order_id, Anda akan menerima pesan ini. Artinya, setidaknya salah satu parameter diperlukan.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}

Menyalin

Jika pembayaran diblokir di akun merchant Anda, Anda akan menerima pesan kesalahan ini. Hal ini terjadi, misalnya, ketika Anda mengubah kata sandi dan pembayaran diblokir selama 24 jam.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5

Menyalin

Jika dompet pedagang yang terhubung ke faktur tidak ada:


1{
2    "state": 1,
3    "message": "Undefined merchant wallet"
4}

Menyalin

Jika faktur tidak diselesaikan atau tidak dibayar.


1{
2    "state": 1,
3    "message": "Refunds are made only for completed payments"
4}

Menyalin

Jika jumlah yang akan dikembalikan melebihi jumlah pembayaran faktur:


1{
2    "state": 1,
3    "message": "The refund amount should not be more than the amount paid"
4}

Menyalin

Jika terjadi pekerjaan teknis dan pembayaran tidak tersedia untuk sementara, Anda mungkin menerima pesan kesalahan ini:


1{
2    "state": 1,
3    "message": "Server error"
4}

Menyalin