# 주문 결제 성공(결제 및 거래 세부 정보 포함) 엑솔라는 사용자가 주문에 대한 결제를 성공적으로 완료하면 지정된 URL로 order_paid 웹훅을 전송합니다. order_paid 웹훅에는 구매한 아이템, 결제 데이터 및 거래 세부 정보에 대한 정보가 포함되어 있습니다. 결제가 성공하지 못한 경우 order_paid 웹훅이 전송되지 않습니다. 예: * 결제 양식이 열렸지만 사용자가 주문을 결제하지 않았습니다. * 결제창이 열렸으나 결제 중 오류가 발생했습니다. order_paid 웹훅의 처리 시간은 3초 이내로 하는 것이 좋습니다. 참고 웹훅에 전송되는 필드 세트는 프로젝트 설정 > 웹훅 > 고급 설정 섹션의 관리자 페이지에서 구성한 설정엑솔라 측에서 구성한 설정 설정에 따라 달라집니다.질문이 있을 경우, 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내십시오. 응답 섹션에서 예상 답변을 볼 수 있습니다. 다른 응답 코드를 사용할 수도 있습니다. 응답 코드 및 자동 결제 환불 기능 연결에 따른 엑솔라 측의 웹훅 처리 로직은 다음과 같습니다. 응답 코드 자동 결제 환불이 비활성화됨(기본값) 자동 결제 환불이 비활성화됨 400, 401, 402, 403, 404, 409, 422, 415 작업 없음 사용자에게 자동 환불 200, 201, 204 작업 없음 작업 없음 웹훅에 다른 코드 또는 응답 없음 5분 간격으로 2번, 15분 간격으로 7번, 60분 간격으로 10번 등 지정한 시간 간격으로 웹훅을 여러 번 전송합니다. 5분 간격으로 2번, 15분 간격으로 7번, 60분 간격으로 10번 등 지정한 시간 간격으로 웹훅을 여러 번 전송합니다. 모든 웹훅을 전송해도 응답을 성공적으로 받지 못하면 사용자에게 환불이 자동으로 이루어집니다. 자동 환불 기능을 연결하려면 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일 전송하십시오. Endpoint: POST successful-order-payment Version: 1.0 ## Request fields (application/json): - `billing` (object) 거래 및 결제 세부 정보. - `billing.notification_type` (string, required) 알림 유형. - `billing.payment_details` (object, required) 결제 내역 관련 값. - `billing.payment_details.country_wht` (object) 국경 간 거래(대상)로 인해 특정 국가에서 적용되는 원천징수세. - `billing.payment_details.country_wht.amount` (number) 금액. - `billing.payment_details.country_wht.currency` (string) 통화. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)에 따른 3자리 통화 코드입니다. - `billing.payment_details.country_wht.percent` (number) 국가 원천징수세율(%). - `billing.payment_details.direct_wht` (object) 직접 원천징수세. - `billing.payment_details.direct_wht.percent` (number) 직접 원천징수세율. - `billing.payment_details.payment` (object) 게임유저 결제 데이터 관련 값. - `billing.payment_details.payment_method_fee` (object) 결제 방식 수수료율. - `billing.payment_details.payment_method_sum` (object) 결제 방법에서 청구된 금액에 대한 데이터가 포함된 값. - `billing.payment_details.payout` (object) 지급 내역 관련 값. - `billing.payment_details.payout_currency_rate` (string) 결제 통화를 지급 통화로 환전할 때의 환율. - `billing.payment_details.repatriation_commission` (object) 본국 송금 비용에 대한 데이터가 있는 오브젝트. 타사가 엑솔라에 부과. - `billing.payment_details.sales_tax` (object) 판매세(미국과 캐나다만 해당). - `billing.payment_details.sales_tax.percent` (number) 판매세율. - `billing.payment_details.user_acquisition_fee` (object) 제휴 네트워크 및 인플루언서를 통한 구매에 대해 공제된 사용자 확보 수수료의 총액(대상)입니다. - `billing.payment_details.user_acquisition_fee.percent` (number) 사용자 확보 수수료율(%). - `billing.payment_details.vat` (object) VAT 세율(유럽연합만 해당). - `billing.payment_details.vat.percent` (number) 부가가치세율. - `billing.payment_details.xsolla_balance_sum` (object) 엑솔라 잔액에서 청구된 금액에 대한 데이터가 포함된 값. - `billing.payment_details.xsolla_fee` (object) 엑솔라 수수료 요율. - `billing.purchase` (object) 구매 데이터 관련 값. - `billing.purchase.coupon` (object) 쿠폰 데이터 관련 값(이 트랜잭션에 쿠폰이 사용된 경우). - `billing.purchase.coupon.campaign_code` (string) 쿠폰 캠페인 코드. - `billing.purchase.coupon.coupon_code` (string) 쿠폰 코드. - `billing.purchase.gift` (object) 기프트 내역 관련 값. - `billing.purchase.gift.giver_id` (string) 제공자 ID. - `billing.purchase.gift.hide_giver_from_receiver` (string) 수신자에서 제공자 ID를 숨길지 여부. - `billing.purchase.gift.message` (string) 제공자로부터 전송된 메시지. - `billing.purchase.gift.receiver_email` (string) 기프트 수령인 이메일. - `billing.purchase.gift.receiver_id` (string) 기프트 수령인 ID. - `billing.purchase.promotions` (array) 이 트랜잭션에 적용된 프로모션. - `billing.purchase.promotions.id` (integer) 프로모션 ID. - `billing.purchase.promotions.technical_name` (string) 프로모션의 기술명. - `billing.purchase.subscription` (object) 정기결제 내역 관련 값. - `billing.purchase.subscription.amount` (number) 구매 금액입니다. - `billing.purchase.subscription.date_create` (string) 정기결제 생성 날짜입니다. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 날짜 및 시간입니다. - `billing.purchase.subscription.date_next_charge` (string) 다음 충전 날짜. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 날짜 및 시간. - `billing.purchase.subscription.plan_id` (string) 요금제 ID(API를 통해 생성된 경우, 외부 ID). - `billing.purchase.subscription.product_id` (string) 상품 ID(액세스 토큰으로 보낸 경우). - `billing.purchase.subscription.subscription_id` (integer) 엑솔라 시스템 내의 정기결제 ID입니다. - `billing.purchase.subscription.tags` (array) 플랜 태그. - `billing.purchase.total` (object, required) 구매 총 가격 데이터 관련 값. - `billing.purchase.total.amount` (number) 총 구매 금액. - `billing.settings` (object) 사용자 정의 프로젝트 설정 관련 값. - `billing.settings.merchant_id` (integer) 판매자 ID입니다. - `billing.settings.project_id` (integer) 프로젝트 ID. 이 매개 변수는 [관리자 페이지](https://publisher.xsolla.com/)의 프로젝트 이름 옆에서 확인할 수 있습니다. - `billing.transaction` (object, required) 트랜잭션 데이터 관련 값. - `billing.transaction.agreement` (integer) 계약 ID. - `billing.transaction.dry_run` (integer) 테스트 트랜잭션. 테스트 트랜잭션의 경우 매개 변수는 1개 값을 갖습니다. 또는, 트랜잭션이 실제로 이루어지는 경우 매개 변수가 전송되지 않습니다. - `billing.transaction.external_id` (string) 거래 외부 ID. 자세한 내용은 [FAQs](/ko/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id)를 참조해 주세요. - `billing.transaction.id` (integer) 트랜잭션 ID. - `billing.transaction.payment_date` (string) 결제 날짜. - `billing.transaction.payment_method` (integer) 결제 수단 ID. - `billing.transaction.payment_method_name` (string) 결제 방식 이름. - `billing.transaction.payment_method_order_id` (string) 결제 시스템의 결제 ID. - `custom_parameters` (object) 추가 정보입니다. - `items` (array, required) 사용자가 구매한 아이템 목록입니다. 배열에 포함된 매개 변수 집합은 웹훅 버전에 따라 다릅니다. 버전 2에는 is_free, is_bonus 및 is_bundle_content와 같은 추가 매개 변수가 포함되어 있습니다. 버전을 전환하려면 [웹훅 설정](/ko/api/igs/operation/update-webhook/) API 호출에 대한 정보 업데이트에서 version 매개 변수 번호를 전달하십시오. - `order` (object, required) 주문에 대한 정보입니다. - `order.amount` (string, required) 선택한 통화를 기준으로 한 장바구니의 총 비용입니다. - `order.comment` (string,null, required) 주문에 대한 사용자의 코멘트. - `order.coupons` (array) 적용된 쿠폰. 쿠폰을 적용되지 않았으면 배열이 돌아오지 않습니다. - `order.coupons.code` (string) 적용된 쿠폰 코드. - `order.coupons.external_id` (string) 외부 ID. - `order.currency` (string, required) 주문 통화. 가상 화폐는 SKU를 사용하고 실제 화폐는 3글자 [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 코드를 사용합니다. - `order.currency_type` (string, required) 결제 통화 유형. 무료 주문의 경우 unknown 값이 지정됩니다. Enum: "real", "virtual", "unknown", "loyalty_point" - `order.id` (integer, required) 엑솔라 측에서 사용자 주문의 고유 식별자입니다. - `order.invoice_id` (string,null, required) 실질 화폐 결제 인보이스 ID. 인게임 재화 결제 또는 무료 아이템은 null 값을 사용합니다. - `order.mode` (string, required) 결제 모드. 실제 결제에는 default를 사용합니다. 테스트 결제에는 sandbox를 사용합니다. Enum: "default", "sandbox" - `order.platform` (string,null, required) 결제 플랫폼. xsolla 값은 엑솔라를 통한 결제에 사용됩니다. 기타 결제는 게임 퍼블리싱 플랫폼의 이름에 해당하는 값을 사용합니다. Enum: "xsolla", "playstation_network", "xbox_live", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other" - `order.promocodes` (array) 적용된 프로모션 코드. 프로모션 코드가 적용되지 않았으면 배열이 돌아오지 않습니다. - `order.promocodes.code` (string) 적용된 프로모션 코드의 코드. - `order.promotions` (array, required) 전체 주문에 프로모션을 적용했습니다. 배열은 다음의 경우에 반환됩니다. - 프로모션이 총 구매 금액에 영향을 미치는 경우(예: 구매 할인 설정이 적용된 프로모션 코드). - 구매에 할인이 적용되지 않지만, 보너스 아이템이 주문에 추가된 경우. 이 경우, 할인이 적용된 가격([amount_with_discount](/ko/webhooks/#operation/order-cancellation!path=order/promotions/amount_with_discount&t=request)) 및 할인이 적용되지 않은 가격([amount_without_discount](/ko/webhooks/#operation/order-cancellation!path=order/promotions/amount_without_discount&t=request))은 할인이 적용되지 않으므로 반환되고 동일하게 유지됩니다. 주문 수준 프로모션이 적용되지 않으면 빈 배열이 반환됩니다. - `order.promotions.amount_with_discount` (string) 할인이 적용된 아이템의 총 비용. - `order.promotions.amount_without_discount` (string) 할인이 미적용된 아이템의 총 비용. - `order.promotions.sequence` (integer) 프로모션 신청 순서입니다. - `order.status` (string, required) 주문 상태. - `user` (object, required) 사용자 정보. - `user.country` (string) 사용자의 국가. [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에 따른 2자로 된 국가 코드를 사용합니다. - `user.email` (string, required) 사용자 이메일 주소. - `user.external_id` (string, required) 사용자 ID. ## Response 200 fields ## Response 400 fields