워드프레스에 베트남 결제 기능을 추가하는 방법은 무엇인가요?

5월, 일, 2025
딕페이
베트남 결제

워드프레스 웹사이트에 베트남 결제 기능을 추가하려면 대상 사용자와 비즈니스 요구 사항에 따라 적합한 결제 게이트웨이를 선택해야 합니다. 아래는 자세한 구현 계획입니다:

I. 베트남 주류 결제 솔루션

로컬 결제 게이트웨이::
- MoMo(권장)
- ZaloPay
- ViettelPay
- VNPAY(은행 송금용)
국제 결제 플랫폼::
- PayPal(베트남 계정 지원 확인 필요)
- 스트라이프(2023년부터 베트남 판매자 지원)

II. 구체적인 구현 단계

옵션 A: 전용 플러그인 사용(권장)

VNPAY 공식 플러그인

1. 플러그인 다운로드: https://sandbox.vnpayment.vn/plugins/

2. WooCommerce 설정 → 결제 → VNPAY 게이트웨이 활성화

3. 판매자 ID 및 키를 구성합니다(VNPAY 판매자 계정 등록 필요).

MoMo 통합 프로그램

// 다음 API를 통해 액세스할 수 있습니다:



    $endpoint = "https://payment.momo.vn/v2/gateway/api/create";

    $파트너코드 = "YOUR_CODE";

    $accessKey = "YOUR_ACCESS_KEY";

    //... 기타 필요한 매개변수

B: WooCommerce 통합(전자상거래 사이트에 적합)

1️⃣ _설치_ '우커머스'  

2️⃣ _게이트웨이 확장자 추가_:.

- [ ] `WooViet` 플러그인(베트남 시장에 최적화)  

- [ ] `WC-베트남-결제-게이트웨이`

3️⃣ _테스트를 위한 샌드박스 환경 구성하기_

C: API 직접 인터페이스(개발자용)

//샘플: ZaloPay 콜백 처리 코드 스니펫 



add_action('rest_api_init', function(){

 register_rest_route('zalopay/v1','/callback', [

 'methods' => 'POST',

 '콜백' => '핸들_잘로페이_콜백'

 ]);

});

III. 중요 고려 사항

⚠️ 규정 준수 요구 사항::

법령 TPP/TT53에 따라 거래 데이터는 최소 5년 동안 보관해야 합니다.
NRB는 추가 외환 신고를 요구할 수 있습니다.

💱 통화 설정 제안:

update_option('woocommerce_currency', 'VND');

update_option('woocommerce_price_thousand_sep', '.') ;

📌 성능 최적화 팁: 동시 접속자가 많은 트랜잭션의 경우 사용하는 것이 좋습니다.
✔️ VNPT용 Ipay 솔루션
✔️ BankPlus의 엔터프라이즈 API

테스트 단계에서는 각 플랫폼의 샌드박스 환경을 사용하고, 프로덕션 환경에서는 PCI DSS 인증을 신청해야 합니다.

특정 결제업체에 대한 보다 구체적인 구현이 필요한 경우 기술 스택(라라벨/우 등 사용 여부)을 알려주시면 맞춤형 코드 샘플을 제공해드릴 수 있습니다.

다음은 다양한 기술 스택에 대한 베트남 페이먼트의 심층 통합 솔루션 및 고급 최적화 권장 사항입니다:

I. 기술 스택별로 세분화된 구현 프로그램

1. WooCommerce 관련 구성(전자상거래 시나리오)
"`php
// 테마의 functions.php에 사용자 정의 게이트웨이 추가(예: MoMo)
add_filter('woocommerce_payment_gateways', 'add_momo_gateway');
함수 add_momo_gateway($gateways){
$게이트웨이[] = 'WC_MoMo_게이트웨이';
$게이트웨이를 반환합니다.
}

WC_MoMo_Gateway 클래스는 WC_Payment_Gateway를 확장합니다.
공용 함수 __construct() {
$this->id = 'momo';
$this-> has_fields = false;
$this->method_title = __('MoMo 월렛', 'textdomain');
//...기타 초기화 설정
}
}
“`

주요 매개변수 구성:
- 반환 URL`은 베트남에 있는 서버의 도메인 이름이어야 합니다.
- 최소 단위로 변환할 거래 금액(1,000VND은 1000으로 제출해야 함)

2. 라라벨 하이브리드 개발 프로그램
"`bash
# 결제 SDK 패키지 설치하기
작곡가 요구 사항 VNPAY/VNPAY-SDK-PHP MOIP/MOIP-SDK
“`

"`php
// Blade 템플릿에 임베드된 결제 버튼 샘플(VNPAY):
@if(config('payment.vnpay.enabled'))

푸시('스크립트')

엔드푸시
@endif
“`

II. 은행 직접 연결에 대한 특별 대우

비엣콤뱅크/비엣틴뱅크 및 기타 은행 도킹 포인트:

1. 필요한 자료:
- 기업의 사업자 등록증 공증 사본
- SWIFT 코드 신청 양식
- PCI DSS 준수 인증서

2. 기술 인터페이스의 차이:
"`diff
+ BankPlus 시스템 요구 사항 SOAP 프로토콜 호출
- VCB SmartPay는 TLS1.3 암호화만 지원합니다.
“`

3. 조정 문서 처리 스크립트 예시(Python).
"`python
# auto_reconcile.py

def process_vcb_statement(file).
PANDAS를 PD로 가져오기

df = pd.read_excel(file, skiprows=5) # VCB 형식은 테이블 헤더를 건너뛰어야 합니다.

인덱스의 경우, df.iterrows():::
행['상태'] == '완료':
업데이트_우커머스_주문(
order_id=row['참조'],
트랜잭션_id=row['추적 ID']
)
“`

III. 성능 및 안전 강화

A) 높은 동시성 최적화 프로그램

| 전략 | 구현 | 시나리오
|——–|————|————|
| Redis는 트랜잭션 상태를 캐시합니다 | `SETEX momo:order:1234 "pending"` | >최대 트랜잭션의 경우 100TPS |
| GeoDNS 인텔리전트 라우팅 | AWS Route53 + 호치민 노드 | CDN 가속 정적 리소스 |

B) PCI DSS 준수 체크리스트

✅ _필수 항목_:
1️⃣ [ ] TLS 인증서는 베트남 CA 기관(GPKI/Safe-CA)에서 발급한 인증서로 대체됩니다.
2️⃣ [ ] MySQL 감사 로깅 활성화 및 오프사이트 백업
3️⃣ [ ] 토큰화가 원본 카드 번호 저장을 대체합니다.

❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ 금지된 작업_:
▢ 금액 매개변수를 전달하는 GET 메서드
▢ CVV/CVC 입력의 JS 직접 처리

IV. 디버깅 및 문제 해결 가이드

일반적인 오류 코드 처리:
“`
VNPAY_ERROR_07 → IP 화이트리스트에 서버 주소가 포함되어 있지 않습니다(판매자 백엔드에서 추가해야 함).
MOMO_ERROR_113 → QR코드가 만료되었습니다(재생성 필요).
ZALOPAY_TIMEOUT → nginx 튜닝 keepalive_timeout >60초
“`

로그 수집 명령의 예입니다:
"`bash
# 워드프레스 전용 디버그 모드(프로덕션 환경에서는 주의해서 사용)
tail -f wp-content/plugins/woocommerce/logs/* \ \
/var/log/nginx/payment-api.log \
/tmp/vnpay_callback.log
“`

특정 은행에 테스트 계좌 번호 또는 샌드박스 자격 증명이 필요한 경우 다음 기관에 대한 테스트 정보 템플릿을 제공할 수 있습니다:
- Vietcombank 샌드박스 신청서
- MoMo 개발자 테스트 지갑 등록 절차

구현 세부 사항 중 어떤 부분이 더 우려되는지 구체적으로 알려주시면 더 정확한 기술 문서를 제공해 드리겠습니다.

워드프레스에 베트남 결제 기능을 추가하는 방법은 무엇인가요?