모의 결제 게이트웨이 샌드박스

결제 API의 응답 방식을 배워 보세요. 공개된 테스트 카드로 승인, 거절, 3-D Secure를 완전히 오프라인에서 시뮬레이션합니다.

🔒 교육용 시뮬레이터입니다. 은행, 카드 네트워크, 결제 서비스 제공업체에 연결하지 않습니다. 공개된 테스트 카드 번호만 허용됩니다.

공개된 테스트 카드 번호

카드 번호	네트워크	시뮬레이션 결과
4242 4242 4242 4242	Visa	결제 성공
4000 0000 0000 0002	Visa	거절: generic_decline
4000 0000 0000 9995	Visa	거절: insufficient_funds
4000 0000 0000 0069	Visa	거절: expired_card
4000 0000 0000 0127	Visa	거절: incorrect_cvc
4000 0000 0000 0119	Visa	오류: processing_error
4000 0025 0000 3155	Visa	3-D Secure 인증 필요
5555 5555 5555 4444	Mastercard	결제 성공
3782 822463 10005	American Express	결제 성공

테스트 카드 번호유효기간 (MM/YY)CVC

금액통화

결제 흐름의 작동 방식

서버가 payment intent를 생성하고 확인하면 게이트웨이가 상태로 응답하고, 이후 웹훅이 백엔드에 최종 결과를 알려 줍니다. 주문 처리는 브라우저 리디렉션이 아닌 웹훅을 기준으로 하세요.

요청 예시

{
  "method": "POST",
  "path": "/v1/payment_intents",
  "body": {
    "amount": 2000,
    "currency": "usd",
    "confirm": true,
    "payment_method_data": {
      "type": "card",
      "card": {
        "number": "4242424242424242",
        "exp_month": 12,
        "exp_year": 2030,
        "cvc": "123"
      }
    }
  }
}

응답 예시

{
  "id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
  "object": "payment_intent",
  "livemode": false,
  "amount": 2000,
  "currency": "usd",
  "status": "succeeded",
  "payment_method": {
    "type": "card",
    "card": {
      "brand": "visa",
      "last4": "4242",
      "exp_month": 12,
      "exp_year": 2030
    }
  },
  "latest_charge": {
    "id": "ch_test_8h2j4k6l1m3n5p7q9r0s2t4u",
    "authorization_code": "T4K2Q9",
    "outcome": {
      "network_status": "approved_by_network",
      "type": "authorized"
    }
  }
}

웹훅: payment_intent.succeeded

{
  "id": "evt_test_1a2b3c4d5e6f7g8h9i0j1k2l",
  "object": "event",
  "type": "payment_intent.succeeded",
  "livemode": false,
  "data": {
    "object": {
      "id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
      "status": "succeeded",
      "amount": 2000,
      "currency": "usd"
    }
  }
}

웹훅: payment_intent.payment_failed

{
  "id": "evt_test_9z8y7x6w5v4u3t2s1r0q9p8o",
  "object": "event",
  "type": "payment_intent.payment_failed",
  "livemode": false,
  "data": {
    "object": {
      "id": "pi_test_7f6e5d4c3b2a1z0y9x8w7v6u",
      "status": "requires_payment_method",
      "last_payment_error": {
        "type": "card_error",
        "code": "card_declined",
        "decline_code": "insufficient_funds",
        "message": "Your card has insufficient funds."
      }
    }
  }
}

모의 결제 게이트웨이 샌드박스 소개

이 모의 결제 게이트웨이 샌드박스를 이용하면 개발자가 실제 돈을 건드리지 않고 카드 결제 API의 응답 방식을 익힐 수 있습니다. 공개된 테스트 카드 번호 중 하나를 고르고, 미래의 유효기간, CVC, 금액을 입력한 뒤 결제 시뮬레이션을 누르세요. 페이지는 일반적인 payment intent 형태의 JSON 객체를 반환합니다. ID, 상태, 카드 네트워크와 마지막 4자리, 실패 시 거절 코드와 메시지, 승인 시 가짜 승인 코드가 포함됩니다. 3-D Secure 카드는 시뮬레이션된 인증 단계를 보여 주므로 requires_action 상태 처리를 연습할 수 있으며, 모든 결과에는 해당하는 웹훅 이벤트가 포함됩니다. 시뮬레이터는 전적으로 브라우저에서 실행되며 은행, 카드 네트워크, 결제 서비스 제공업체에 연결하지 않고, 표에 나열된 공개 테스트 번호만 허용합니다. 실제 카드 번호는 로컬에서 거부되며 어디에도 전송되지 않습니다.

FAQ

샌드박스가 카드에 요금을 청구하거나 은행에 연결하나요?

아니요. 모든 것이 브라우저에서 시뮬레이션됩니다. Visatk, 은행, 카드 네트워크, 결제 서비스 제공업체로 어떤 요청도 전송되지 않으며 돈이 이동하지 않습니다.

제 카드 번호가 거부되는 이유는 무엇인가요?

샌드박스는 표에 있는 공개 테스트 번호만 허용합니다. 실제 카드를 포함한 그 외의 번호는 로컬에서 거부되므로 승인된 것으로 처리되지 않습니다.

이 번호를 실제 결제 서비스 제공업체에서 사용할 수 있나요?

이 번호들은 결제 서비스 제공업체의 테스트 모드에서 널리 공개된 테스트 번호입니다. 제공업체 샌드박스의 테스트 API 키로만 작동하며, 라이브 모드에서는 항상 거절됩니다.