엑솔라는 다음 조건이 충족되면 지정된 URL로 order_paid
웹훅을 전송합니다.
payment
웹훅의 성공적인 처리에 대한 응답을
받았습니다.order_paid
웹훅에는 구매한 아이템 및 거래 세부 정보에 대한 정보가 포함되어 있습니다.
다음과 같은 경우 order_paid
웹훅이 전송되지 않습니다.
payment
웹훅의 성공적인 처리에 대한 응답을 받지
못했습니다.order_paid
웹훅의 처리 속도는 3초 이내로 하는 것이 좋습니다.
응답 섹션에서 예상 답변을 볼 수 있습니다. 다른 응답 코드를 사용할 수도 있습니다. 응답 코드 및 자동 결제 환불 기능 연결에 따른 엑솔라 측의 웹훅 처리 로직은 다음과 같습니다.
응답 코드 | 자동 결제 환불이 비활성화됨(기본값) | 자동 결제 환불이 활성화됨 |
---|---|---|
400 , 401 , 402 , 403 , 404 , 409 , 422 , 415 |
작업 없음 | 사용자에게 자동 환불 |
200 , 201 , 204 |
작업 없음 | 작업 없음 |
웹훅에 다른 코드 또는 응답 없음 | 5분 간격으로 2번, 15분 간격으로 7번, 60분 간격으로 10번 등 지정한 시간 간격으로 웹훅을 여러 번 전송합니다. | 5분 간격으로 2번, 15분 간격으로 7번, 60분 간격으로 10번 등 지정한 시간 간격으로 웹훅을 여러 번 전송합니다. 모든 웹훅을 전송해도 응답을 성공적으로 받지 못하면 사용자에게 환불이 자동으로 이루어집니다. |
자동 환불 기능을 연결하려면 프로젝트 계정 관리자에게 문의하거나 am@xsolla.com으로 이메일을 보내주세요.
notification_type required | string 알림 유형입니다. | ||||||||||||||||||||||||||||||||||||||
required | Array of objects 사용자가 구매한 아이템 목록입니다. | ||||||||||||||||||||||||||||||||||||||
Array | |||||||||||||||||||||||||||||||||||||||
required | object 주문에 대한 정보입니다. | ||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
required | object 사용자 정보. | ||||||||||||||||||||||||||||||||||||||
custom_parameters | object 추가 정보. |
성공적인 처리 표시를 반환합니다.
제공된 정보에 오류가 있는 경우 반환합니다(예: 필수 매개변수 누락, 인증 실패 등).
{- "custom_parameters": { },
- "items": [
- {
- "amount": "string",
- "custom_attributes": null,
- "is_pre_order": true,
- "promotions": [
- {
- "amount_with_discount": "string",
- "amount_without_discount": "string",
- "sequence": 0
}
], - "quantity": 0,
- "sku": "string",
- "type": "virtual_good"
}
], - "notification_type": "string",
- "order": {
- "amount": "string",
- "comment": "string",
- "coupons": [
- {
- "code": "string",
- "external_id": "string"
}
], - "currency": "string",
- "currency_type": "real",
- "id": 0,
- "invoice_id": "string",
- "mode": "default",
- "platform": "xsolla",
- "promocodes": [
- {
- "code": "string",
- "external_id": "string"
}
], - "promotions": [
- {
- "amount_with_discount": "string",
- "amount_without_discount": "string",
- "sequence": 0
}
], - "status": "string"
}, - "user": {
- "email": "string",
- "external_id": "string"
}
}