So'rovlar va javoblar uchun imzo yaratish¶
Imzo algoritmi¶
buyurtma yaratish so'rovi va javobidagi signature parametri, shuningdek callbacks
sha1 funksiyasi yordamida hosil qilinadi. Savdogarning to'lov maxfiy kaliti va barcha
So'rov yoki javob parametrlari, alifbo tartibida guruhlangan va | belgisi bilan ajratilgan.
Misol
Savdo so'rovi:
curl -i -X POST \
-H "Content-Type:application/json" \
-d \
'{
"request": {
"server_callback_url": "http://myshop/callback/",
"order_id": "TestOrder2",
"currency": "UZS",
"merchant_id": 4056281,
"order_desc": "Test payment",
"amount": 1000,
"signature": "91ea7da493a8367410fe3d7f877fb5e0ed666490"
}
}' \
'https://pay.payme.uz/api/checkout/url'
Imzoni tuzish uchun ishlatiladigan satr:
test|1000|GEL|4056281|Test payment|TestOrder2|http://myshop/callback/
test sinov ma'lumotlaridan olingan maxfiy to'lov kalitidir sinov ma'lumotlari
Agar parametr yo'qolgan yoki bo'sh bo'lsa, '|' belgisini qo'shish shart emas.
response_url va server_callback_url ga POST javobida imzo tekshirish misoli:
namespace Ipsp;
/**
* Class Signature
* @package Ipsp
*/
class Signature {
/**
* @var
*/
private static $password;
/**
* @var
*/
private static $merchant;
/**
* Set merchant password
* @param String $password
* @return mixed
*/
public static function password($password){
self::$password = $password;
}
/**
* Set merchant id
* @param String $merchant
* @return mixed
*/
public static function merchant( $merchant ){
self::$merchant = $merchant;
}
/**
* Generate request params signature
* @param array $params
* @return string
*/
public static function generate(Array $params){
$params['merchant_id'] = self::$merchant;
$params = array_filter($params,'strlen');
ksort($params);
$params = array_values($params);
array_unshift( $params , self::$password );
$params = join('|',$params);
return(sha1($params));
}
/**
* Sign params with signature
* @param array $params
* @return array
*/
public static function sign(Array $params){
if(array_key_exists('signature',$params)) return $params;
$params['signature'] = self::generate($params);
return $params;
}
/**
* Clean array params
* @param array $data
* @return array
*/
public static function clean(Array $data){
if( array_key_exists('response_signature_string',$data) )
unset( $data['response_signature_string'] );
unset( $data['signature'] );
return $data;
}
/**
* Check response params signature
* @param array $response
* @return bool
*/
public static function check(Array $response){
if(!array_key_exists('signature',$response)) return FALSE;
$signature = $response['signature'];
$response = self::clean($response);
return $signature == self::generate($response);
}
}
from hashlib import sha1
def get_signature(secret_key, params):
"""
:param secret_key: merchant secret
:param params: POST parameters
:return: signature string
"""
data = [secret_key]
data.extend([str(params[key]) for key in sorted(iter(params.keys()))
if params[key] != '' and not params[key] is None
and key != 'signature'])
return sha1('|'.join(data).encode('utf-8')).hexdigest()
signature¶
'signature' tasdiqlash xatosi yuzaga keladigan ikkita tipik holat mavjud.
1-holat: Payme API chaqiruviga javoban¶
Buyurtma yaratish, buyurtmani bekor qilish, holatini olish yoki signature parametriga ega boshqa har qanday so'rov yuborilganda
savdogar tomonidan Payme API ga yuboriladi va javob qaytariladi:
{
"response": {
"error_code": 1014,
"error_message": "Invalid signature",
"request_id": "3mwpcKoenYZ0w",
"response_status": "failure"
}
}
Agar Payme APIga so'rov yuborilsa va javob "error_message": "Invalid signature" ko'rinishida qaytarilsa,
Quyidagi tekshiruvlarni bajaring:
-
to'g'ri to'lov maxfiy kalitini ishlatganingizga ishonch hosil qiling:
-
Agar so'rovda Lotin bo'lmagan kodlash mavjud bo'lsa, u UTF-8 kodlashda yuboriladi
-
0 qiymatga ega parametr dasturlash tilingizda nol deb talqin qilinmasligiga ishonch hosil qiling
-
Imzo parametrini yaratishda SHA1 qo'llagan kod satrini logga qayd eting. Uni xato matnida qaytarilgan (qizil rangda belgilangan) satr bilan solishtiring:
“Invalid signature signature:6bd069be8a6e2f2bbe176df00ba63cc681ca38aa; response_signature_string:**********|125|UZS|4056281|demo order 789|Demo123456“.Matnda xato borligini e'tiborga oling Savdogarning to'lov kaliti*belgisi bilan yashiriladi. -
API so'rovida bo'sh parametrlar yuborilayotganini tekshiring. Agar shunday bo'lsa, imzoda ishlatiladigan satrda, | Har bir bunday bo'sh parametr uchun ajratuvchi belgini kiritish shart emas
-
Agar PHP dasturlash tilida ishlayotgan bo'lsangiz, misol funksiyasidan foydalaning
php-inline public static function generate(Array $params): -
SHA1 funksiyasi natijasining kichik harflar bilan yozilganligiga ishonch hosil qiling. To'g'ri:
6bd069be8a6e2f2bbe176df00ba63cc681ca38aa. Noto'g'ri:6BD069BE8A6E2F2BBE176DF00BA63CC681CA38AA -
Imzo parametrini imzo hisob-kitobingizga kiritilmasligiga ishonch hosil qiling
-
/api/recurring, API endpointsidan foydalanganda imzo (signatura)da faqat zarur parametrlarni kiritganingizga ishonch hosil qiling, lekin /api/redirect manzilidagi endpointdan emas
2-holat: server_callback_url ga callback yuborilganda yoki response_url ga yo'naltirilganda¶
Payme serveri server_callback_url yoki response_url manzillariga POST javobini yoki callbackni qaytarganda
va siz o'zingizning imzoingizni yaratib, uni POST javobidagi signature parametri bilan solishtirmoqdasiz,
signatures mos kelmasin
Agar Payme API server_callback_url yoki response_url manzillaridagi sahifalarga POST javobini qaytarsa
parametrlar, lekin imzo yaratishga va uni POST javobidagi imzo parametriga solishtirishga harakat qilganingizda,
imzo mos kelmaydi
{
"response": {
"rrn": "",
"masked_card": "",
"sender_cell_phone": "",
"sender_account": "",
"currency": "UZS",
"fee": "",
"reversal_amount": "0",
"settlement_amount": "0",
"actual_amount": "",
"response_description": "",
"sender_email": "",
"order_status": "expired",
"response_status": "success",
"order_time": "28.02.2018 19:18:16",
"actual_currency": "",
"order_id": "TestOrder2",
"tran_type": "purchase",
"eci": "",
"settlement_date": "",
"payment_system": "",
"approval_code": "",
"merchant_id": 4056281,
"settlement_currency": "",
"payment_id": 83456044,
"card_bin": "",
"response_code": "",
"card_type": "",
"amount": "1000",
"signature": "268b8f189f97c85696134fe6ae0f7f5ab93f28d5",
"product_id": "",
"merchant_data": "",
"rectoken": "",
"rectoken_lifetime": "",
"verification_status": "",
"parent_order_id": "",
"fee_oplata": "0",
"additional_info": "{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": null, \"transaction_id\": null, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": null, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": null, \"card_product\": null, \"card_category\": null, \"timeend\": \"01.03.2018 05:18:17\", \"ipaddress_v4\": \"52.30.149.20\", \"payment_method\": null}",
"response_signature_string": "**********|{\"capture_status\": null, \"capture_amount\": null, \"reservation_data\": null, \"transaction_id\": null, \"bank_response_code\": null, \"bank_response_description\": null, \"client_fee\": null, \"settlement_fee\": 0.0, \"bank_name\": null, \"bank_country\": null, \"card_type\": null, \"card_product\": null, \"card_category\": null, \"timeend\": \"01.03.2018 05:18:17\", \"ipaddress_v4\": \"52.30.149.20\", \"payment_method\": null}|1000|UZS|0|4056281|TestOrder2|expired|28.02.2018 19:18:16|83456044|success|0|0|purchase"
}
}
Imzo nomuvofiqligining sababini aniqlash uchun quyidagi qadamlarni bajaring:
- 0 qiymatga ega parametr dasturlash tilingizda bo'sh satrga yoki null qiymatga aylanmasligiga ishonch hosil qiling
- response_signature_string va signature parametrlari imzoni hisoblashda hisobga olinmasligiga ishonch hosil qiling ( response_signature_string parametri faqat savdogar sinov rejimida bo'lsa qaytariladi va imzo qanday tuzilishini ko'rsatadigan ma'lumotni o'z ichiga oladi javoban yaratilgan)
- Agar so'rov lotin bo'lmagan belgilarni o'z ichiga olsa, u UTF-8 kodlashda yuboriladi
- Dastur kodida imzo parametrini yaratishda SHA1 qo'llanadigan satrni ajratib ko'rsating.
Natijani
response_signature_stringparametrida qaytarilgan satr bilan solishtiring - Javobda bo'sh parametrlar qaytarilganini tekshiring. Agar shunday bo'lsa, imzoning bir qismi bo'lgan satrda, Har bir bo'sh parametr uchun | belgisini kiritish shart emas
- SHA1 funksiyasi natijasining kichik harflar bilan yozilganligiga ishonch hosil qiling.
To'g'ri:
6bd069be8a6e2f2bbe176df00ba63cc681ca38aa. Noto'g'ri:6BD069BE8A6E2F2BBE176DF00BA63CC681CA38AA