# 결제 사용자가 결제를 완료하면 엑솔라는 payment 유형이 포함된 웹훅의 결제 세부 정보를 웹훅 URL로 전송합니다. 예상되는 응답 코드는 Responses 섹션에 설명되어 있지만 다른 응답 코드도 사용할 수 있습니다. 응답 코드 설명 200, 201, 204 성공적인 응답입니다. 4xx 오류가 발생했습니다. 예를 들어, 지정된 사용자를 찾을 수 없거나 잘못된 서명이 전달된 경우입니다. 5xx 일시적인 서버 오류입니다. 이 응답이 수신되면 엑솔라는 자동으로 웹훅 전송을 재시도하며, 수신자가 수신을 확인할 때까지 시도 간격을 점차 늘립니다. 최대 재시도 횟수는 48시간 동안 12회입니다. 관리자 페이지에서 웹훅 URL을 저장할 때 웹훅을 통해 추가 정보를 수신하도록 설정할 수도 있습니다. 참고 2025년 1월 22일 또는 그 이전에 관리자 페이지에 등록한 경우, 설정 >웹훅 > 테스트 > 결제 > 고급 설정 섹션에서 토글을 찾을 수 있습니다. 토글 설명 저장된 결제 계정에 대한 정보 표시 저장된 결제 방식에 대한 정보는 payment_account 사용자 정의 개체에서 전달됩니다. 저장된 결제 방식을 사용한 트랜잭션에 대한 정보 표시 정보는 웹훅의 다음 사용자 정의 매개 변수에서 전달됩니다.saved_payment_method:0 - 저장된 결제 방식이 사용되지 않음1 - 현재 결제를 진행할 때 결제 방식이 저장됨2 - 이전에 저장한 결제 방식이 사용됨payment_type:1 - 일회성 결제2 - 반복 결제 주문 개체를 웹훅에 추가 주문 관련 정보는 결제 웹훅의 order 개체에서 전달됩니다. 민감한 데이터 없이 필수 사용자 매개 변수만 전송 사용자에 대한 다음 정보만 웹훅에서 전달됩니다.ID국가 카드 BIN 및 접미사 표시 은행 카드 번호에 대한 다음 정보가 웹훅에서 전달됩니다.card_bin 매개 변수의 처음 6자리card_suffix의 마지막 4자리 카드 브랜드 표시 결제에 사용된 카드의 브랜드. 예: Mastercard 또는 Visa. 참고 웹훅으로 전송되는 필드 세트는 관리자 페이지에서 구성한 고급 설정엑솔라 측에 구성한 사용자 지정 설정에 따라 달라집니다. 질문이 있는 경우, 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내십시오. Endpoint: POST payment Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) 사용자 정의 매개 변수. - `notification_type` (string, required) 알림 유형. - `payment_details` (object, required) 결제 내역 관련 값. - `payment_details.country_wht` (object) 국경 간 거래(대상)로 인해 특정 국가에서 적용되는 원천징수세. - `payment_details.country_wht.amount` (number) 금액. - `payment_details.country_wht.currency` (string) 통화. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)에 따른 3자리 통화 코드입니다. - `payment_details.country_wht.percent` (number) 국가 원천징수세율(%). - `payment_details.direct_wht` (object) 직접 원천징수세. - `payment_details.direct_wht.percent` (number) 직접 원천징수세율. - `payment_details.payment` (object) 게임유저 결제 데이터 관련 값. - `payment_details.payment_method_fee` (object) 결제 방식 수수료율. - `payment_details.payment_method_sum` (object) 결제 방법에서 청구된 금액에 대한 데이터가 포함된 값. - `payment_details.payout` (object) 지급 내역 관련 값. - `payment_details.payout_currency_rate` (string) 결제 통화를 지급 통화로 환전할 때의 환율. - `payment_details.repatriation_commission` (object) 본국 송금 비용에 대한 데이터가 있는 오브젝트. 타사가 엑솔라에 부과. - `payment_details.sales_tax` (object) 판매세(미국과 캐나다만 해당). - `payment_details.sales_tax.percent` (number) 판매세율. - `payment_details.user_acquisition_fee` (object) 제휴 네트워크 및 인플루언서를 통한 구매에 대해 공제된 사용자 확보 수수료의 총액(대상)입니다. - `payment_details.user_acquisition_fee.percent` (number) 사용자 확보 수수료율(%). - `payment_details.vat` (object) VAT 세율(유럽연합만 해당). - `payment_details.vat.percent` (number) 부가가치세율. - `payment_details.xsolla_balance_sum` (object) 엑솔라 잔액에서 청구된 금액에 대한 데이터가 포함된 값. - `payment_details.xsolla_fee` (object) 엑솔라 수수료 요율. - `purchase` (object) 구매 데이터 관련 값. - `purchase.checkout` (object) 체크아웃 내역 관련 값. - `purchase.checkout.amount` (number) 구매 금액. - `purchase.coupon` (object) 쿠폰 데이터 관련 값(이 트랜잭션에 쿠폰이 사용된 경우). - `purchase.coupon.campaign_code` (string) 쿠폰 캠페인 코드. - `purchase.coupon.coupon_code` (string) 쿠폰 코드. - `purchase.gift` (object) 기프트 내역 관련 값. - `purchase.gift.giver_id` (string) 제공자 ID. - `purchase.gift.hide_giver_from_receiver` (string) 수신자에서 제공자 ID를 숨길지 여부. - `purchase.gift.message` (string) 제공자로부터 전송된 메시지. - `purchase.gift.receiver_email` (string) 기프트 수령인 이메일. - `purchase.gift.receiver_id` (string) 기프트 수령인 ID. - `purchase.order` (object) 주문에 대한 정보가 포함된 개체입니다. 이 정보를 받으려면 프로젝트 설정 > 웹훅 > 고급 설정 섹션의 [관리자 페이지](https://publisher.xsolla.com/)에서 웹훅에 주문 개체 추가 토글을 온으로 설정해 주세요. - `purchase.order.id` (integer) 주문 ID. - `purchase.order.lineitems` (array) 아잍템에 대한 정보를 포함하는 매개 변수 배열. - `purchase.order.lineitems.price` (object) 아이템 가격에 대한 정보가 포함된 개체. - `purchase.order.lineitems.price.amount` (number) 선택한 통화로 표시된 아이템의 총 가격. - `purchase.order.lineitems.price.currency` (string) 아이템 가격의 통화. - `purchase.order.lineitems.quantity` (integer) 아이템 수량. - `purchase.order.lineitems.sku` (string) 아이템 SKU. - `purchase.promotions` (array) 이 트랜잭션에 적용된 프로모션. - `purchase.promotions.id` (integer) 프로모션 ID. - `purchase.promotions.technical_name` (string) 프로모션의 기술명. - `purchase.subscription` (object) 정기결제 내역 관련 값. - `purchase.subscription.amount` (number) 구매 금액입니다. - `purchase.subscription.date_create` (string) 정기결제 생성 날짜입니다. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 날짜 및 시간입니다. - `purchase.subscription.date_next_charge` (string) 다음 충전 날짜. [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 날짜 및 시간. - `purchase.subscription.plan_id` (string) 요금제 ID(API를 통해 생성된 경우, 외부 ID). - `purchase.subscription.product_id` (string) 상품 ID(액세스 토큰으로 보낸 경우). - `purchase.subscription.subscription_id` (integer) 엑솔라 시스템 내의 정기결제 ID입니다. - `purchase.subscription.tags` (array) 플랜 태그. - `purchase.total` (object, required) 구매 총 가격 데이터 관련 값. - `purchase.total.amount` (number) 총 구매 금액. - `settings` (object) 사용자 정의 프로젝트 설정(개체). - `settings.merchant_id` (integer) 판매자 ID입니다. - `settings.project_id` (integer) 프로젝트 ID. 이 매개 변수는 [관리자 페이지](https://publisher.xsolla.com/)의 프로젝트 이름 옆에서 확인할 수 있습니다. - `transaction` (object, required) 트랜잭션 데이터 관련 값. - `transaction.agreement` (integer) 계약 ID. - `transaction.dry_run` (integer) 테스트 트랜잭션. 테스트 트랜잭션의 경우 매개 변수는 1개 값을 갖습니다. 또는, 트랜잭션이 실제로 이루어지는 경우 매개 변수가 전송되지 않습니다. - `transaction.external_id` (string) 거래 외부 ID. 자세한 내용은 [FAQs](/ko/doc/pay-station/references/faq/#faq_payments_q_new_transaction_external_id)를 참조해 주세요. - `transaction.id` (integer) 트랜잭션 ID. - `transaction.payment_date` (string) 결제 날짜. - `transaction.payment_method` (integer) 결제 수단 ID. - `transaction.payment_method_name` (string) 결제 방식 이름. - `transaction.payment_method_order_id` (string) 결제 시스템의 결제 ID. - `user` (object) 사용자 세부 사항(개체). - `user.country` (string) 사용자의 국가. [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에 따른 2자로 된 국가 코드를 사용합니다. - `user.email` (string) 사용자 이메일. - `user.id` (string, required) 사용자 ID. - `user.ip` (string) 유저 IP 주소입니다. - `user.name` (string) 사용자 이름. - `user.phone` (string) 유저 전화 번호입니다(국제 형식). - `user.zip` (string) 우편번호. ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields