webhook url regist - nicepayments/nicepay-manual GitHub Wiki

μ›Ήν›… URL 등둝

μ›Ήν›… URL κΈ°λŠ₯μ΄λž€?

μ›Ήν›…(Webhook) μ΄λž€?

νŠΉμ • μ΄λ²€νŠΈκ°€ λ°œμƒν–ˆμ„ λ•Œ 미리 μ§€μ •λœ URL둜 HTTP μš”μ²­μ„ μžλ™μœΌλ‘œ λ³΄λ‚΄λŠ” 방식을 λ§ν•©λ‹ˆλ‹€.

이λ₯Ό 톡해 μ„œλ²„λ‚˜ μ›Ή μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ€ μ‹€μ‹œκ°„μœΌλ‘œ 데이터λ₯Ό κ΅ν™˜ν•˜κ±°λ‚˜ νŠΉμ • μž‘μ—…μ„ μˆ˜ν–‰ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

λ‚˜μ΄μŠ€νŽ˜μ΄λ¨ΌμΈ μ—μ„œ μ›Ήν›… URL 등둝은 결제 승인, μ·¨μ†Œμ‹œ 성곡 건에 λŒ€ν•΄μ„œ λ“±λ‘ν•œ URL둜 κ²°μ œμ²˜λ¦¬μ— λŒ€ν•œ 톡보λ₯Ό ν•˜λŠ” κ°œλ…μœΌλ‘œ μ‚¬μš©λ©λ‹ˆλ‹€.

μ›Ήν›… λ°œμ†‘(이벀트 λ°œμƒ) μ‹œμ 

  • πŸ’³ 결제(승인) λ˜μ—ˆμ„ λ•Œ(λͺ¨λ“  μ§€λΆˆμˆ˜λ‹¨)
  • κ°€μƒκ³„μ’Œκ°€ λ°œκΈ‰(μ±„λ²ˆ) λ˜μ—ˆμ„ λ•Œ
  • κ°€μƒκ³„μ’Œμ— κ²°μ œκΈˆμ•‘μ΄ μž…κΈˆ λ˜μ—ˆμ„ λ•Œ
  • κ²°μ œκ°€ μ·¨μ†Œ μ²˜λ¦¬λ˜μ—ˆμ„ λ•Œ (API λ˜λŠ” κ°€λ§Ήμ κ΄€λ¦¬μž μ·¨μ†Œ)

βš οΈμ›Ήν›… 응닡 방법 주의 ⚠️

  • μ›Ήν›… μ‘λ‹΅μœΌλ‘œ HttpStatus: 200와, Content-Type: text/html νƒ€μž…μ˜ OK λ¬Έμžμ—΄ 응닡 값을 κ²€μ¦ν•©λ‹ˆλ‹€.

μ›Ήν›… URL 등둝 방법

μ›Ήν›… URL 등둝에 λŒ€ν•œ F&Q

Q1. "Message: HTTP response body에 'OK' λ¬Έμžμ—΄μ„ μ‘λ‹΅ν•΄μ£Όμ„Έμš”." λΌλŠ” 응닡을 λ°›μŠ΅λ‹ˆλ‹€.

A. λ‚˜μ΄μŠ€νŽ˜μ΄λ¨ΌμΈ κ°€ μš”μ²­ν•˜λŠ” μ›Ήν›… endpoint λͺ…세에 λΆ€ν•©ν•œμ§€ ν™•μΈν•΄μ£Όμ„Έμš”.
특히 응닡 μ‹œ `Content-Type`이 `application/json`이 μ•„λ‹Œ Content-type: text/html νƒ€μž…μ— `OK` λ¬Έμžμ—΄λ‘œ μ‘λ‹΅ν•˜μ–΄μ•Ό ν•©λ‹ˆλ‹€.
β†—οΈκ²°μ œν†΅λ³΄ μš”μ²­ λͺ…μ„Έ
β†™οΈκ²°μ œν†΅λ³΄ 응닡 λͺ…μ„Έ

Copyright 2023. NICE Payments. all rights reserved.

⚠️ **GitHub.com Fallback** ⚠️