스퀘어 결제 이전 점검기를 따로 팔 수 있다

하나였던 거래 연결이 세 갈래로 나뉘었다

스퀘어의 응용 프로그램 연결 규칙, 곧 다른 프로그램이 결제 명령과 결과를 주고받는 방식이 바뀌었다. 스퀘어는 2019년 8월 15일 기존 Transactions API를 새 결제·환불 방식으로 대체한다고 알렸고, 약 7년이 지난 2026년 9월 16일 기존 쓰기 작업을 끝냈다.

더는 기존 방식으로 신규 결제, 환불, 승인된 결제의 완료, 승인 취소를 처리할 수 없다. 대상은 Charge, CreateRefund, CaptureTransaction, VoidTransaction 네 가지이며, 이전 버전을 지정해도 다시 쓸 수 없다.

과거 거래 조회는 당장 사라지지 않았다. 따라서 새 결제는 Payments API, 환불은 Refunds API, 품목·세금·주문은 Orders API에서 처리하면서 예전 거래는 기존 방식으로 읽는 기간이 생겼다.

이름만 바꾸면 끝나는 일도 아니다. 중복 결제를 막는 요청번호의 최대 길이가 192자에서 45자로 줄었고, 팁을 포함한 합계를 읽는 항목도 달라졌다. 완료된 결제만 환불할 수 있으며 승인 상태의 결제는 환불이 아니라 취소해야 하고, 한 결제는 1년 안에 최대 20번까지 환불할 수 있다.

한국에서 만들 사람은 시장 범위도 먼저 봐야 한다. 스퀘어가 결제 처리를 지원한다고 밝힌 곳은 미국·캐나다·일본·호주·영국·아일랜드·프랑스·스페인이고 한국은 포함되지 않는다. 국내 원화 결제 도구보다는 이들 국가의 판매자를 고객으로 둔 한국 제작사나 해외 한인 매장을 대상으로 해야 한다.

큰 관리 프로그램에서 점검 도구가 떨어져 나온다

예를 들어 직원 여덟 명인 한국 회사가 미국 네일숍 60곳의 예약과 선결제를 관리한다고 하자. 운영책임자 민지는 예약번호 하나로 결제와 환불을 처리해 왔고, 매장 직원은 관리 화면에서 환불 버튼만 눌렀다.

기존 Transactions API 중심 연동에서 다루던 결제수단·환불·주문 관련 정보가 새 구조에서는 Payments·Refunds·Orders API로 나뉜다. 그래서 결제 연결을 고치는 일도 예약·고객관리 프로그램을 만든 업체가 맡았고, 별도의 점검 서비스가 끼어들 자리가 작았다.

이제 민지는 환불 한 건을 확인하려면 예약 주문, 새 결제번호, 결제 상태, 환불 요청, 최종 환불 상태를 차례로 맞춰야 한다. 오래된 거래라면 기존 거래번호도 함께 찾아야 하고, 2021년 이전의 일부 현금·외부결제 환불은 주문 기록까지 확인해야 한다.

이 과정에서 독립적인 이전 점검기가 들어갈 자리가 생긴다. 운영 중인 서비스의 요청 기록이나 코드를 받아 더는 작동하지 않는 네 가지 작업을 찾고, 새 결제·환불·주문 기록이 같은 예약번호로 이어지는지 보여주는 작은 서비스다.

민지는 첫 화면에서 매장별로 ‘기존 환불 호출 3건’, ‘주문 연결 누락 7건’, ‘45자를 넘는 요청번호 12건’을 볼 수 있다. 항목을 누르면 어느 기능에서 문제가 생겼는지, 새 방식에서는 무엇으로 바꿔야 하는지, 시험 결제에서 결과가 일치했는지가 나온다.

이 도구는 실제 카드번호를 다루거나 결제를 대신 승인할 필요가 없다. 고객이 허용한 범위에서 요청 기록과 결제 상태만 비교하면 되므로, 예약·재고·고객관리까지 전부 다시 만드는 것보다 작게 시작할 수 있다.

사람 손에 남는 일도 있다. 주문 취소를 승인할지, 오래된 결제를 다른 수단으로 보상할지, 팁과 수수료 차이를 회계에 어떻게 반영할지는 매장과 운영팀이 결정해야 한다. 점검기는 결정을 대신하는 제품이 아니라 빠진 연결과 실패한 상태를 한곳에 모으는 제품이어야 한다.

다른 곳은 연결의 일부를 이미 상품으로 만들었다

미국 시장을 대상으로 하는 APIExperts는 워드프레스 결제 버튼·폼인 WP Easy Pay와 쇼핑몰 주문·재고를 맞추는 WooSquare Plus를 운영한다. 판매자는 상품과 구독료를 받고, 플러그인은 스퀘어의 결제·주문·고객 연결을 대신 처리한다.

스퀘어용 플러그인을 24개 이상 제공하며 두 핵심 제품은 각각 연결 판매자 4,000곳 이상이라고 밝혔다. 큰 쇼핑몰 프로그램 전체가 아니라 결제 폼, 반복 결제, 주문 동기화 같은 조각도 독립 상품이 될 수 있음을 보여주지만, 스퀘어 사례집에 실린 수치라 별도 확인이 필요하다.

미국과 캐나다의 견인업체용 운영 서비스 Towbook은 2021년 스퀘어 연결을 시작했다. 견인비와 차량 출고비를 현장 단말기, 문자, 이메일 청구서로 받게 하고 그 결과를 견인 업무 기록에 반영한다.

스퀘어는 연결 업체가 1,000곳을 넘고 월 약 4만 건을 처리한다고 소개했다. 한 고객은 카드결제를 손으로 옮겨 적는 일을 없애 주 16시간을 줄였다고 밝혔는데, 이 역시 공급사 사례 수치라 별도 확인이 필요하다.

미국과 아일랜드에 공동 본사를 둔 Stripe는 온라인 사업자의 결제를 처리하고 결제 수수료를 받는다. 처음에는 고객 계정마다 연결 규칙의 버전을 고정하는 방식으로 변경 충격을 막았고, 지금은 Workbench라는 화면에서 사용 중인 버전과 요청량을 확인하게 한다.

새 버전으로 바꾼 뒤 72시간 안에는 이전 버전으로 돌아갈 수 있다. 스퀘어의 이번 종료에는 같은 되돌리기 장치가 없지만, ‘무엇이 바뀌었고 어디서 오류가 나는지 보여주는 화면’ 자체가 별도 운영 기능이 될 수 있다는 선례다.

여기서 나올 수 있는 것들

1. 옛 결제 호출 찾기

운영 중인 코드와 요청 기록에서 종료된 네 가지 작업을 찾아 새 작업과 연결해 주는 점검 서비스다. 미국 카페 30곳의 주문 프로그램을 대신 관리하는 국내 제작사가 쓴다.

기존 호출이 이미 오류를 내는 시점이라 점검 결과를 바로 수정 목록으로 바꿀 수 있다. 첫 화면에는 서비스별 옛 호출 수, 마지막 사용 시각, 바꿀 작업, 담당자를 놓는다.

2. 환불 상태 추적함

환불 접수부터 진행 중, 완료, 실패까지 한 줄로 보여주고 오래 멈춘 건을 알려 주는 서비스다. 미국에서 예약금을 받는 한인 미용실 체인 12곳의 상담팀이 쓴다.

새 환불 방식은 요청이 접수됐다고 바로 완료된 것이 아니므로 상담 화면이 따로 필요해졌다. 첫 화면에는 오늘 요청한 환불, 진행 중인 시간, 실패 이유, 고객에게 다시 연락할 건을 놓는다.

3. 결제·주문 금액 맞추기

결제 금액과 주문의 품목·세금·팁을 매일 비교해 차이가 난 건만 골라 주는 서비스다. 캐나다 식당용 주문 앱에서 여러 매장의 정산을 맡는 재무담당자가 쓴다.

결제와 주문 정보가 서로 다른 연결로 나뉘고 팁을 포함한 합계 항목도 달라져 수기 대조가 늘 수 있다. 첫 화면에는 매장별 결제 합계, 주문 합계, 차이 금액, 원인 후보를 놓는다.

4. 옛 거래와 새 거래를 잇는 고객 화면

기존 거래 기록과 새 결제·환불·주문 기록을 고객 한 명의 시간순 내역으로 합쳐 주는 조회 서비스다. 2021년 전부터 스퀘어를 써 온 미국 행사 등록 서비스의 고객지원팀이 쓴다.

읽기는 남고 새 처리는 다른 방식으로 옮겨가면서 한 고객의 기록이 두 군데로 갈라졌기 때문이다. 첫 화면에는 고객 검색창과 함께 주문, 결제, 취소, 환불의 시간순 상태를 놓는다.

오늘 확인해 볼 것

개발업체에 현재 운영 코드에서 Charge, CreateRefund, CaptureTransaction, VoidTransaction 네 이름을 검색한 화면을 보내 달라고 요청하자. 30분 안에 결과를 받을 수 있고, 시험용 파일이 아닌 실제 운영 기능에서 하나라도 나오면 이전 점검기의 첫 고객 문제가 이미 존재한다고 판단할 수 있다.