거부된 결제

Xsolla Developers

또는

거부된 결제Webhook POST

결제 시스템에서 트랜잭션이 거부되면 엑솔라는 구성된 웹훅 URL 측의 ps_declined 유형 웹훅에 트랜잭션 세부 정보를 전송합니다. 웹훅은 승인 또는 결제 처리 단계에서 전송됩니다. 이 경우, payment\ order_paid 웹훅이 전송되지 않았습니다.

결제 시스템이 거부되는 일반적인 이유:

카드 승인에 실패(예: 기술적 오류 또는 은행의 응답이 없어 결제 시스템이 승인 절차를 완료하지 못함)했거나 거부되었습니다(예: 은행에서 응답했지만 자금이 부족하거나 카드 정보가 유효하지 않아 트랜잭션을 거부함).
3-D Secure 검증에 실패했거나, 완료되지 않았거나, 사용자 확인 시간이 초과되었습니다.
계좌 폐쇄 또는 유효하지 않은 카드 번호 등 되돌릴 수 없는 오류로 인해 처리업체 또는 매입 은행이 일시적으로 접속이 불가능하거나 강제 거부 메시지를 반환합니다. 근본적인 문제를 해결하지 않고 재시도하면 트랜잭션이 성공적으로 이루어지지 않습니다.

다음과 혼동되어서는 안 됩니다.

사기 방지 거부는 afs_reject 웹훅을 통해 보고됩니다.
성공적인 결제 후 환불 및 부분 환불은 환불 및 partial_refund 웹훅을 통해 보고됩니다.

참고

ps_declined 웹훅을 수신하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.

Request

Request Body schema: application/json

notification_type

required

string

알림 유형.

required

object

트랜잭션 데이터 관련 값.

dry_run	integer 테스트 트랜잭션. 테스트 트랜잭션의 경우 매개 변수는 1개 값을 갖습니다. 또는, 트랜잭션이 실제로 이루어지는 경우 매개 변수가 전송되지 않습니다.
external_id	string 트랜잭션 외부 ID.
id	integer 트랜잭션 ID.
payment_method	integer 결제 수단 ID.

object

환불 세부 정보(개체).

author

string

환불 시작자. 필드 값이 다음 표에 따라 전달됩니다.

환불 시작자	필드 값
게임(API를 통해).	API
게시자 계정 사용자(자동 환불).	사용자 이메일
게시자 계정 사용자(엑솔라 고객 지원의 도움을 받아).	support@xsolla.com
엑솔라(엑솔라 고객 지원의 도움을 받아).	support@xsolla.com

code

integer

코드 ID.

reason

string

환불 이유.

object

사용자 정의 프로젝트 설정(개체).

merchant_id	integer 판매자 ID입니다.
project_id	integer 프로젝트 ID. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

object

사용자 세부 사항(개체).

id required	string 사용자 ID.
country	string 사용자의 국가. ISO 3166-1 alpha-2 standard에 따른 2자로 된 국가 코드를 사용합니다.
email	string 사용자 이메일.
ip	string 유저 IP 주소입니다.
name	string 사용자 이름.

Responses

204

성공적인 처리 표시를 반환합니다.

400

제공된 정보에 오류가 있는 경우 반환됩니다(예: 필수 매개변수 누락, 인증 실패 등). 이 경우 사용자의 돈은 인출되지만 구매는 실패합니다. 환불을 진행하려면 support@xsolla.com으로 엑솔라 고객 지원에 문의해 주세요.

500

서버에 일시적인 오류가 있음을 표시하려면 돌아가세요.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 80543ba63e1e50cf05f15150fe75e7245da9a898' \
-d '{
  "notification_type": "ps_declined",
  "settings": {
    "project_id": "18404",
    "merchant_id": "2340"
  },
  "user": {
    "ip": "127.0.0.1",
    "email": "email@example.com",
    "id": "1234567",
    "country": "US"
  },
  "transaction": {
    "id": "1",
    "dry_run": "1",
    "payment_method": "1"
  },
  "refund_details": {
    "author": "support@xsolla.com",
    "code": "8",
    "reason": "Cancellation by the PS request",
    "reason_detail": "Insufficient funds"
  }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}