İşlem İadesi

Method URL İçerik-Türü
POST /api/refund Application/json


Tür Parametreler Data Türü Şart
HEADER Authorization string Zorunlu
HEADER Accept string Zorunlu
KEY invoice_id string Zorunlu
KEY amount string Zorunlu
KEY app_id string Zorunlu
KEY app_secret string Zorunlu
KEY merchant_key string Zorunlu
KEY hash_key string Zorunlu
KEY refund_transaction_id string Zorunlu
KEY refund_web_hook_key string Opsiyonel

Authorization

Authorization bağlantı girişimine izin verildiğini doğrulayan tanımlayan bir başlık anahtarıdır. Yöntem “Bearer” olmalıdır.

Örnek değer:

Bearer

eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImRlMGVlZGFiZjdhZDhk
ODYzYTgyMzQ4Nzk5NTFkYzFlMDZkZTUxYjU0NWRjYmU3MzRjMmQ1OGN
kMWFlOWE4YjliZTkyMjdlZGVmZDdlMDliIn0.eyJhdWQiOiIxNSIsImp0aSI6ImR
lMGVlZGFiZjdhZDhkODYzYTgyMzQ4Nzk5NTFkYzFlMDZkZTUxYjU0NWRjYm
U3MzRjMmQ1OGNkMWFlOWE4YjliZTkyMjdlZGVmZDdlMDliIiwiaWF0IjoxNTcz
NzUyNDcyLCJuYmYiOjE1NzM3NTI0NzIsImV4cCI6MTYwNTM3NDg3Miwic3Vi
IjoiMSIsInNjb3BlcyI6W119.mDtdzcv15p8SnYjZYJUJrhdskO5NohXbkcAxKWWZ
72lNtrg86RZ1yxQwfQlRu6IPoa1rfG3M4jfsNeH-Sh7g6PaVffIoKvjdcUG7Cc2lLqh
E4qMEdPgO28luCMOFf6UHn6XxeEhK3XWaboZJvrubdeb0t04a6btrdHUa-FgeV
6I8bNSRlzUjOjBcsVrd1pxKhKnsREFHCWfzYVC_ZQ4RRCi9CZsJGz7_KQ
8mo0BdNmtbNKwfvYkpcdsmVicsJYvnw7OMZ3u-TorhakndhQkUK0JPAzl_LSHq
AKCju8dTG1-vZjbh9ifRB85TGwW4HimQk46RPG9Hp6kydLnuhFOkbvGpaxcs5q
yZ67-cmjDa6aeGNjZHfNa7dQ8bTokdbkxqwKrVVUUVjgkMtPXhpL9yffaHHPNBCk
c-1Vz40nsmNFeaoWlk2S7fDxFTcGYv8HFFiSRyfsPpfTbXPIRMoZUX1kC4c-DMyQ
mjuBqtxIwEFzJexs9PkZEUze5Qcm_ZrkqeKUlL4tJidO9ZzwfCI9bpihMATHlD
yM6IP7XyhgMRt3yr2WvzxuxavqSyu09YlybYU0WpTUtDVOavL7xnuKBXhwDSoCjt
CMh__tL9ZfK9lDvq6mrHQ5Z4RXLixvWMbl98_Btbnfg_SqnCNYwL14FSHyeb3lnuF8VFyERwbf-tAlI

Accept

Accept client tarafında ne tür bir temsilin isteneceğini belirler. Değer “application / json” olmalıdır

invoice_id

invoice_id satıcı tarafından gönderilen benzersiz bir sipariş kimliğidir.

amount

amount iade edilecek tutardır

app_id

app_id SiPay tarafından sağlanan benzersiz bir kimliktir.

app_secret

app_secret SiPay tarafından sağlanan gizli bir anahtardır

merchant_key

merchant_key SiPay tarafından sağlanan benzersiz üye işyeri anahtarıdır

Hash Key Oluşturma

function generateRefundHashKey($amount, $invoice_id, $merchant_key, $app_secret) {

    $data = $amount.'|'.$invoice_id.'|'.$merchant_key;

    $iv = substr(sha1(mt_rand()), 0, 16);
    $password = sha1($app_secret);

    $salt = substr(sha1(mt_rand()), 0, 4);
    $saltWithPassword = hash('sha256', $password . $salt);

    $encrypted = openssl_encrypt(
        "$data", 'aes-256-cbc', "$saltWithPassword", null, $iv
    );

    $msg_encrypted_bundle = "$iv:$salt:$encrypted";
    $hash_key = str_replace('/', '__', $msg_encrypted_bundle);

    return $hash_key;
}

Başarılı Yanıt:

{
      "status_code": 100,
    "status_description": "Refund completed successfully",
    "order_no": "15925741639038",
    "invoice_id": "66955",
    "ref_no": "5454545dgdgd545545"
}

Başarısız Yanıt

{

    "status_code": 49,
    "status_description": "Refund Failed",
    "order_no": "15925741639038",
    "invoice_id": "66955",
    "ref_no": ""

}