Signature Algorithm, eg: 978594372956732
PayKKa API reference (v3)
正文application/json必需
PAYMENT.AUTHORIZATION: 支付已授权事件
PAYMENT.SUCCESS: 支付成功事件
PAYMENT.FAILURE: 支付失败事件
PAYMENT.CANCELED: 支付取消事件
REFUND.SUCCESS: 退款成功事件
REFUND.FAILURE: 退款失败事件
枚举"PAYMENT.AUTHORIZATION""PAYMENT.SUCCESS""PAYMENT.FAILURE""PAYMENT.CANCELED""REFUND.SUCCESS""REFUND.FAILURE"
币种; 传ISO 3166-1支持的货币三字码
枚举"CNY""USD""JPY""RUB""EUR""GBP""HKD""AUD""CAD""INR"
示例: "USD"
PROCESSING: 支付中
SUCCESS: 支付成功
AUTHORIZED: 未请款
FAILURE: 支付失败
REFUNDED: 已退款
PARTIALLY_REFUNDED: 已部分退款
CANCELED: 已取消
PARTIALLY_REVERSED: 已部分撤销
枚举"PROCESSING""SUCCESS""AUTHORIZED""FAILURE""REFUNDED""PARTIALLY_REFUNDED""CANCELED""PARTIALLY_REVERSED"
- Generated server url
https://openapi.paykka.com/v3/payment/acq/NotifyUrlOfYourPayments
- cURL
- Python
- PHP
- Node.js
- Ruby
- Java
- ApacheHttpClint
- Go
- JS
- C#
curl -i -X POST \
https://openapi.paykka.com/v3/payment/acq/NotifyUrlOfYourPayments \
-H 'Content-Type: application/json' \
-H 'x-paykka-appid: 978594372956732' \
-H 'x-paykka-nonce: 4326048250346354435' \
-H 'x-paykka-sign: Mif3gh48xxxxxxxxx' \
-H 'x-paykka-sign-alg: SHA256_WITH_RSA' \
-H 'x-paykka-timestamp: 1757387467986' \
-d '{
"notify_type": "PAYMENT.AUTHORIZATION",
"merchant_id": "18356675194960",
"trans_id": "m58129512",
"order_id": "GW2056xxxxx2136685",
"status": "AUTHORIZED",
"amount": 199,
"currency": "EUR",
"session_id": "CS20602223728587",
"shopper_reference": "f4911bc8b17106a08f2f7a89a9fc4d11",
"expire_time": "2025-03-08T10:00:00+08:00",
"payment": {
"payment_method": "BANKCARD"
},
"card_info": {
"bin": "424242",
"last4": "4242",
"card_brand": "VISA"
}
}'
响应
无内容
正文application/json必需
PAYMENT.AUTHORIZATION: 支付已授权事件
PAYMENT.SUCCESS: 支付成功事件
PAYMENT.FAILURE: 支付失败事件
PAYMENT.CANCELED: 支付取消事件
REFUND.SUCCESS: 退款成功事件
REFUND.FAILURE: 退款失败事件
枚举"PAYMENT.AUTHORIZATION""PAYMENT.SUCCESS""PAYMENT.FAILURE""PAYMENT.CANCELED""REFUND.SUCCESS""REFUND.FAILURE"
币种; 传ISO 3166-1支持的货币三字码
枚举"CNY""USD""JPY""RUB""EUR""GBP""HKD""AUD""CAD""INR"
示例: "USD"
REVIEWING: 审核中
PROCESSING: 退款中
SUCCESS: 成功
FAILURE: 失败
枚举"REVIEWING""PROCESSING""SUCCESS""FAILURE"
- Generated server url
https://openapi.paykka.com/v3/payment/acq/NotifyUrlOfYourRefund
- cURL
- Python
- PHP
- Node.js
- Ruby
- Java
- ApacheHttpClint
- Go
- JS
- C#
curl -i -X POST \
https://openapi.paykka.com/v3/payment/acq/NotifyUrlOfYourRefund \
-H 'Content-Type: application/json' \
-H 'x-paykka-appid: 978594372956732' \
-H 'x-paykka-nonce: 4326048250346354435' \
-H 'x-paykka-sign: Mif3gh48xxxxxxxxx' \
-H 'x-paykka-sign-alg: SHA256_WITH_RSA' \
-H 'x-paykka-timestamp: 1757387467986' \
-d '{
"timestamp": 1744976074556,
"notify_type": "REFUND.SUCCESS",
"error_code": "0000",
"error_description": "request success",
"merchant_id": "18356675194960",
"trans_id": "m58129512",
"refund_order_id": "RG20324325320129",
"order_id": "GW2056xxxxx2136685",
"status": "SUCCESS",
"amount": 2,
"currency": "USD",
"pay_finish_time": "2025-04-18T19:34:34+08:00"
}'
响应
无内容