Conekta (멕시코)
카드 · OXXO · SPEI.
Conekta 는 멕시코 · 중남미용 결제사입니다. 카드, 편의점 현금 결제(OXXO), 계좌이체(SPEI)를 받습니다. 결제 통화는 MXN 또는 USD 이고, 멕시코 법인 계약이 필요합니다.
Conekta 대시보드 > 개발자 > API 키에 비밀 키가 있습니다. 테스트 키는 key_test_, 운영 키는 key_live_ 로 시작합니다.
결제수단 탭에서 Conekta(멕시코 · 중남미) 에 체크하고
- Conekta 비밀 키: 넣은 뒤 연결 확인으로 바로 검증합니다.
- 결제수단: 카드 · 현금(OXXO) · 계좌이체(SPEI) 중 켤 것을 체크합니다. 호스티드 결제 페이지에 이 수단들이 나타납니다.
- Conekta 결제 통화: MXN 또는 USD.
- 원화 주문도 이 결제수단으로 결제할 수 있게 한다: 켜면 원화 주문을 공용 환율로 환산해 받습니다.
저장합니다.
Conekta 대시보드 > 웹훅에 짓미페이의 웹훅 주소를 넣고 order.paid, order.expired 이벤트를 켭니다. OXXO · SPEI 는 손님이 나중에 입금하므로 이 웹훅이 있어야 결제완료로 바뀝니다.
테스트 키에서는 Conekta 가 안내하는 테스트 카드번호로 승인됩니다. OXXO 를 고르면 바코드가 발급되고 대시보드에서 입금을 흉내 낼 수 있습니다.
결제 내역에 "conekta" 결제 완료, 결제 상세의 PG 거래번호에 ord_ 로 시작하는 주문 ID 가 보입니다. 통신 로그에 ready → webhook(pending_payment) → webhook(paid) 순서로 남습니다.
운영 전환
운영 키(key_live_)로 바꾸고 테스트 모드를 끕니다. 웹훅도 운영 환경에 다시 등록합니다.
웹훅 로그에 "unknown order" 가 있어요: 다른 사이트(테스트 사이트 등)에 같은 키를 써서 그쪽 주문 통지가 함께 오는 경우입니다. 사이트마다 키를 분리하세요. OXXO 결제가 결제 대기로만 남아요: 손님이 아직 편의점에서 입금하지 않은 상태입니다. 입금하면 웹훅으로 바뀝니다. 만료 기한은 Conekta 설정을 따릅니다.