개발자
결제 API
쇼핑몰 빌더나 Stripe, 토스페이먼츠 웹훅으로 안 잡히는 결제를 내 서버가 확인한 직후 한 번 보내요. 예) KG이니시스, NHN KCP, 나이스페이, 토스 자동결제(빌링), 키인 결제.
키 만들기
설정 → 매출 연결 → 결제 API 키 만들기. 키는 adp_pay_ 로 시작해요. 서버에만 두세요. 브라우저 코드에 넣으면 남이 매출을 써 넣을 수 있어요.
보내는 법
curl -X POST https://app.finallydata.com/api/v1/payments \
-H "Authorization: Bearer adp_pay_…" \
-H "Content-Type: application/json" \
-d '{"transaction_id":"order_123","amount":29000,"currency":"KRW","adp_visitor_id":"<쿠키 _adp_v 값>"}'| 칸 | 필수 | 뜻 |
|---|---|---|
transaction_id | 필수 | 주문(결제) 번호. 같은 번호는 한 줄이라, 다시 보내면 금액과 환불 상태만 고쳐요 |
amount | 필수 | 원이나 달러 같은 화폐 단위 (센트 아님) |
currency | KRW, USD 같은 세 글자. 없으면 사이트의 기준 화폐 | |
adp_visitor_id | 권장 | 손님 브라우저의 쿠키 _adp_v 값. 있어야 이 결제가 어느 채널에서 왔는지 이어져요 |
refunded | true 면 환불 (매출에서 빠져요) | |
renewal | true 면 구독 갱신, false 면 새 결제 | |
subscription_id | 구독 번호. 있으면 고객 가치 탭의 구독 화면(MRR, 해지율)에 이어져요 | |
customer_id | 회원 번호. 회원 기준 재구매를 켰다면 기기가 달라도 같은 사람으로 이어요 (가명으로만 저장) | |
timestamp | 결제 시각 (ISO 8601). 없으면 받은 시각 |
응답
- 성공하면 200 과 ok: true
- 400: 칸이 틀렸어요. 응답의 message 가 어느 칸이 왜 틀렸는지 알려 줘요
- 401: 키가 없거나 틀렸어요. 409: 사이트가 수집을 멈춘 상태예요. 413: 16KB 를 넘었어요. 429: 잠시 뒤 다시
설정 → 매출 연결에서 “마지막으로 받은 결제” 시각으로 잘 들어오는지 확인할 수 있어요.