크립토 카지노
토렌트 기어
공급자에게 API 결제가 작동하는 방
결제 API는 응용 프로그램과 "결제 생성", "3DS 확인", "반품 자금", "클라이언트 지불" 및 "상태 반복" 을 신뢰할 수 있고 반복 가능한 통화로 전환하는 공급자 간의 계약입니다. 후드 아래에는 토큰 화, demempotency, webhooks, 사기 방지, 대기열, SLA 및 감사와 같은 수십 가지 규칙이 있습니다. 아래는 이것이 대부분의 공급자에게 어떻게 작동하는지에 대한 실용적인
기본 모델: 거의 항상 엔티티가 무엇인가
지불/청구-상각 시도 (승인 + 캡처 또는 즉시 구매).
결제 방법-카드 (PAN/토큰), 은행 계좌/별칭, 지갑, 로컬 방법.
고객-고객/지불 기관 (때로는 선택 사항).
지불/이체-클라이언트/판매자에게 발신 결제.
환불/반전-원래 지불 (폐쇄 루프) 로 돌아갑니다.
웹훅 이벤트 - 비동기 상태 알림.
분쟁/청구-결제 네트워크 (카드) 에 대한 분쟁.
주문/음성-결제 관련 비즈니스 컨텍스트.
인증 및 보안
API 키/OAuth 2. 서버 간 서버 용 0/mTLS.
클라이언트 토큰은 비밀을 밝히지 않기 위해 프론트 엔드의 일회용 토큰입니다.
카드 토큰 화-PAN은 공급자에게 전달됩니다. 토큰 만 저장합니다.
PCI DSS-PAN이 표시되면 PCI 영역에 있습니다. 호스팅 된 필드/SDK를 피하고 사용하는 것이 좋습니다.
HMAC 서명 웹 후크-이벤트가 공급자에게서 온 것인지 확인합니다.
듀얼 존 아키텍처-퍼블릭 프론트 (JS/SDK) 및 프라이빗 백엔드 (키, 리스크 로직).
이념성, 대기열 및 일관성
헤더의 Idempotency-Key: 요청을 반복하면 (시간 초과) 복제가 생성되지 않습니다.
"지불 → 원장에게 편지를 보내는 것 → 웹 후크를 기다리는 것" 이 동의되었습니다.
백오프가있는 Retrai-일시적인 오류에만 해당됩니다. 재 시도 가능/복구 불가능한 매트릭스가 필요합니다.
전형적인 종점 (체계 및 흐름)
1) 카드 (비자/마스터 카드 등)
POST/결제-결제 ('금액', '통화', '결제 _ 방법 _ 토큰', '캡처' = 허위/참) 를 생성하십시오.
POST/payment/{ id }/canned - 계정 3-D Secure 2 (챌린지/리디렉션 결과).
POST/payment/{ id }/capture-인증 후 캡처 (부분/전체).
POST/payment/{ id }/repund-반품 (부분적으로 최대 금액).
GET/payming/{ id} - статл겠습니다 (승인, 캡처, 실패, _ action이 필요함).
3-D Secure/SCA: 공급자는 도전을 위해 '필요 _ 작업' + '클라이언트 _ 비밀 '/PK을 반환합니다. 클라이언트가 확인한 후 프론트는 결과를 백엔드로 되돌립니다. → '/확인 '
2) A2A/오픈 뱅킹 (은행 별 지불)
POST/payment → 'redirect _ url' 에서 고객 은행으로의 응답.
클라이언트는 은행 → 웹 후크 결제에 의해 승인됩니다. 성공/실패 '.
GET/payment/{ id} - 최종 상태 (종종 비동기식 만).
3) 로컬 메소드 (PIX, PayID, FPX, iDEAL 등)
POST/payment → 'qr _ code '/' deeplink '/' copy _ code' 를 얻습니다.
사용자를 표시하고 등록에 대한 웹 후크를 기다립니다.
코드 타임 아웃 및 TTL은 계약의 일부입니다.
4) 지불
POST/payouts ('금액', '통화', '대상 _ 토큰' и독점 '카드 _ 토큰 '/' 은행 _ 별칭').
GET/payouts/{ id} - статлс달러 ('대기', '전송', '유료', '실패').
Webhooks 'payout. 지불/실패 '는 진실의 원천입니다.
폐쇄 루프: 대체 전에 소스 (반전) 에 지불하는 것이 바람직합니다.
Webhooks: "진리의 근원"
이벤트: '지불. 보류/승인/캡처/실패 ',' 지불. (PHP 3 = 3.0.6, PHP 4) ',' 지불에 성공했습니다. ',' 분쟁을 지불했습니다. '등을 만들었습니다.
배달: HMAC이 서명 한 배상으로 종종 "적어도 한 번" → 핸들러를 demmpotent로 유지합니다.
모범 사례: 웹 후크 → 원장 업데이트 → 응답 2xx. 모든 비즈니스 로직은 비동기입니다.
오류 및 상태 처리
HTP 코드: '2xx' 성공; '4xx' 클라이언트 오류 (유효성 검사, 사기/은행 오류, 잘못된 토큰); '5xx' -공급자.
"불충분 한 _ funds", 'do _ not _ honour', 'dolled _ card', 'ligent _ ducking', 'risk _ ducking', 'bank _ under'.
재실행 창: 3DS의 경우-끝없이 후퇴 할 수 없습니다. A2A의 경우-리디렉션/코드 TTL이 유효합니다. 지불금-백오프.
사기 방지 및 위험
공급자의 JS/SDK 또는 자체 계층을 통한 장치 지문 및 동작 데이터.
목록: BIN 위험, 흑백 방법 목록/ASN/국가.
조정 가능한 게이트: 새로운 공구, 쿨오프, 속도, RG/AML 임계 값 검사 제한.
정책: 점수 + 규칙에 따른 '통과/강화/보류/차단'.
레일의 기능
카드: 승인 대 청산 (금액을 이동할 수 있음), 3DS2, 원래 거래, 분쟁/청구에 대한 수익률.
A2A/오픈 뱅킹: 리디렉션/동의 흐름, 높은 apruv, 저렴한 비용; 모든 것이 비동기식이며 은행에 크게 의존합니다.
로컬 패스트: QR/별칭, 인스턴트 웹 후크, TTL 및 엄격한 컴파일.
OCT/푸시 투 카드 (카드 결제): 3DS없이 카드 토큰, 발급자의 빠른 자금 지원이 필요합니다.
검증 및 호환성
API 버전: 헤더 또는 phicheflags의 '/v1 ', "데이터 버전".
역으로 호환되는 변경: 비파괴 필드 만.
우선 순위: 마이그레이션 중 이전 버전, 마이그레이션 가이드, 중복 웹 후크 철회 일정.
관찰 및 SLA
메트릭: p95 인증/지불 시간, BIN/은행/방법으로 요금 승인, 배송 비율, 웹 후크 지연.
로그: '요청 _ id', 'demempotency _ key', 'payment _ id' 에 의한 상관 관계.
경고: 특정 은행/국가에 대한 거부 급증, 타임 아웃 증가, 중복 이벤트.
청소 및 금융
원장: 이중 입력, 변경 불가능한 로그, '승인/캡처/환불' 상태.
3면 컴파일: 원장의 웹 후크 공급자/은행 보고서.
참조: 'provider _ reference', 'network _ reference', 'payout _ reference' 유지-지원이 저장됩니다.
샌드 박스, 인증 및 생산
샌드 박스: 테스트 토큰/카드/뱅크, 3DS/리디렉션 시뮬레이션, 웹 후크 상태에 대한 "버튼".
테스트 사례: 성공/실패, 3DS 챌린지, 제공자 타임 아웃, 중복 웹 후크, 부분 캡처/환불, 리디렉션 취소, 지불 실패.
생방송: prod key, webhook 도메인, IP 허용리스트, 사기 방지, 제한 설정 및 경고.
미니 예 (회로도)
결제 (카드)
POST/v1/결제
{
"금액": 9232, "통화": "EUR", "결제 _ 방법 _ 토큰": "pm _ tok _ 123", "캡처": 참, "메타 데이터": {"order _ id": "ORD-1001"}
}
→ 200 {"id": "pay _ abc", "상태": "fordes _ action", "netherd _ action": {"style": "redirect", "all":... ""}}성공적인 등록에 대한 웹 후크
POST/웹 후크
{
"유형": "지불. 캡처, "" data ": {" id ":" pay _ abc "," mount ": 9232," currency ":" EUR "," metadata ": {" order _ id ":" ORD-1001 "}}
}결제
POST/v1/지불
{
"금액": 5000, "통화": "EUR", "대상 _ 토큰": "dest _ tok _ 456", "메타 데이터": {"user _ id": "u _ 77"}
}구현 점검표
1. 주요 아키텍처: 서버 비밀은 별도로, 클라이언트 비밀은 한 번입니다.
2. 이데올로기: 각 쓰기 호출 + demempotent 웹 후크 처리기에서.
3. 웹 후크: HMAC 서명, retrai, 작업 대기열, 지연 모니터링.
4. 3DS/SCA 및 리디렉션: 취소/타임 아웃 처리, 친구 -UX 다시 시도.
5. 사기 방지/제한: 속도, 새로운 세부 사항, 블랙리스트, RG/AML 임계 값.
6. 원장 및 조정: 이중 입력, 3면 조정, 이상 경고.
7. 오케스트레이션: 예비 제공 업체, BIN/country/amits의 라우팅 규칙.
8. 모니터링: 대시 보드는 요율/p95/retrays, 은행/방법에 의한 경고를 승인합니다.
9. 법률/PCI: 토큰 화, 반품 정책, 폐쇄 지불 루프.
10. 분해 계획: 킬 스위치 채널, 대기열, 중요한 작업을위한 수동 모드.
빈번한 실수
PCI 및 토큰 화없이 PAN을 측면에 저장합니다.
demempotency → 타임 아웃과 함께 지불/지불을 중복하지 않습니다.
웹 후크를 고려하지 않고 동기식 응답에 대한 논리.
시장에 출시 된 한 공급자, 대체/캐스케이드 없음.
3DS 실행 취소/리디렉션 처리 → 재활용 쓰레기통을 잃지 않았습니다.
약한 번들 → "동결" 및 "손실" 트랜잭션.
명확한 SLA 및 경고가 없기 때문에 고객이 보는 문제는 귀하가 아닙니다.
미니 -FAQ
동기 상태 또는 웹 후크보다 안정적인 것은 무엇입니까?
Webhook은 진실의 원천입니다. 동기식 응답- "동작 허용/필요".
3DS없이 할 수 있습니까?
규제/위험에 따라 다릅니다. EC/UK에서 - SCA는 필수입니다. 고위험의 경우 스텝 업이 더 좋습니다.
승인률을 높이는 방법?
BIN/은행/방법 오케스트레이션, 로컬 레일, 스마트 레트라, 올바른 설명자, 낮은 FPR 사기 방지.
지불이 "즉각적이지 않은" 이유는 무엇입니까?
레일 (OST/A2A/local), 수령인의 은행 및 한도에 따라 다릅니다. 솔직한 SLA 창과 상태 흐름을 보자.
"결제 생성 '이 아니다. "이 분야: 보안 인증 → 토큰 화 → demempotency → 비동기 웹 후크 → 원장 및 접기 → 사기 방지/AML → 오케스트레이션 및 모니터링. 이 체계에 따라 프로세스를 구축하고 예비 채널과 투명한 UX를 유지하십시오. 결제 계층은 빠르고 예측 가능하며 은행 및 공급자의 실패에 저항합니다.