Agent 전문
Sale Transaction과 Refund Transaction
Sale Transaction 요청
호출
019101 N KRW00000000010000000000000000000000000000 pos010000000000000000CRD 0000
TrackData
결제수단 선택은 Agent를 통해 제공될 수 있으며, 선택된 결제수단은 PaymentMethod 필드에 셋팅되어 Terminal로 전송됩니다.
단, CardPresent=”2”(MOTO)인 경우, 단말기 설정을 무시하고, Keyin을 허용합니다.
단, CardPresent=”2”(MOTO)인 경우, 단말기 설정을 무시하고, Keyin을 허용합니다.
할부기간
Agent에서 선택된 결제수단이 신용카드이고, 할부 설정이 사용이면, Agent에서 입력 받은 후, Terminal로 전송합니다. 단, 국내/해외 신용카드 구분은 불가합니다.
Agent의 할부 설정이 사용 안함이면, Terminal은 입력된 신용카드가 국내 신용카드인 경우, 할부 기간을 입력 받습니다. 해외 신용카드는 할부를 지원하지 않습니다.
Agent의 할부 설정이 사용 안함이면, Terminal은 입력된 신용카드가 국내 신용카드인 경우, 할부 기간을 입력 받습니다. 해외 신용카드는 할부를 지원하지 않습니다.
세금, 봉사료
별도의 입력 화면 없이, 수신한 값으로 처리합니다.
| 항목 | TYPE | LEN | 비고 |
|---|---|---|---|
| CardPresent | AN | 1 | 공백 |
| IsToken | AN | 1 | "N" |
| TrackData | AN | 66 | 공백 |
| IssuerId | AN | 4 | 공백 단, 은련카드 거래일 경우 "IS08" |
| Currency | AN | 3 | 통화 코드 "KRW" |
| Amount | N | 12 | 승인 금액 KRW 10,000 → 10000 |
| Tax | N | 12 | 부가세 |
| Tip | N | 12 | 봉사료 |
| Installment | N | 2 |
할부 개월 수를 2자리로 입력 ex) 일시불 : 00 / 3개월 할부 : 03 |
| Date1 | N | 8 | 공백 |
| Date2 | N | 8 | 공백 |
| POS | AN | 3 | "pos" (소문자) |
| TransactionType | N | 2 | 거래 구분 (Header와 동일한 값 입력) "01" |
| SequenceNo | AN | 12 | POS 자체 Sequence No 없을 경우 0으로 채움 (000000000000) |
| VariableDataLength | N | 4 | "0000" |
| VariableData | AN | 데이터를 기재하지 않음 | |
| PaymentMethod | AN | 3 | 결제수단 |
| WalletIdEntryMode | AN | 2 | 공백 |
| WalletIdLength | N | 4 | "0000" |
| WalletId | AN | 데이터를 기재하지 않음 | |
| TransactionNo | AN | 12 | VAN 거래 고유 번호 (공백 처리 가능) |
Sale Transaction 응답
호출
0434010000 NS 2507527289******030* 000000000000502200000001 000000000150 IS51AQ0113233110 0020250122132331 000000000000 00023147773 92394398 CRDKB국민카드 KB국민카드 000000001000N
| 항목 | TYPE | LEN | 비고 |
|---|---|---|---|
| OfflineFlag | AN | 1 | 오프라인 여부 ( Y / N ) |
| EntryMode | AN | 2 | 카드 입력 구분 |
| ExpiryDate | N | 4 | 유효기간 |
| PAN | AN | 19 | Masked PAN |
| SequenceNo | AN | 12 | SequenceNo |
| TransactionNo | AN | 18 | 거래고유번호 |
| Tip | N | 12 | 봉사료 |
| TransToken | AN | 30 | 공백 |
| IssuerId | AN | 4 | 발급사 코드 |
| AcquirerId | AN | 4 | 매입사 코드 |
| AuthCode | AN | 15 | 승인번호 |
| Installment | N | 2 | 00 : 일시불 |
| TransactionDate | N | 14 | YYYYMMDD24Hmiss |
| BillingCurrency | AN | 3 | 자국통화코드 |
| BillingAmount | N | 12 | 자국통화금액 |
| DCCExchangeRate | AN | 10 | 환율 해당 필드의 첫번째 자리는 환율의 소수점 자리 수를 입력하고 뒤에 환율 입력 EX) 환율 1.123456 일 때 필드 값은 61123456 |
| MerchantId | AN | 15 | 가맹점번호 |
| TerminalId | AN | 8 | 단말기번호 |
| APMCode | AN | 3 | 간편결제 코드 |
| APMName | AN | 20 | 간편결제 명 |
| PaymentMethod | AN | 3 | 결제수단 |
| IssuerName | AN | 20 | 발급사 명 |
| AcquirerName | AN | 20 | 매입사 명 |
| Amount | N | 12 | 승인 금액 KRW 10,000 → 10000 |
| SignFlag | AN | 1 | 서명 거래 유무 (Y / N) |
| ResultMessage | AN | 150 | 응답메세지 - 정상 거래(0000)일 때는 공백 - 그 외 오류 거래에 대해 VAN 사로부터 전달받은 응답메세지 또는 Agent 오류 메시지 전달 |
Refund Transaction 요청
Terminal은 승인 취소와 동일한 프로세스(금액을 제외한 정보 입력)로 처리합니다.
호출
018703 N KRW000000001000 pos030000000000000000CRD 0000 012345 241105
TrackData
Terminal은 신용카드 취소와 간편 결제취소 메뉴를 보여주고, 선택된 결제수단으로 취소를 처리합니다.
해당 결제수단 선택은 Agent를 통해 제공될 수 있으며, 선택된 결제 수단은 PaymentMethod 필드에 셋팅되어 Terminal로 전송됩니다.
단, CardPresent=”2”(MOTO)인 경우, 단말기 설정을 무시하고, Keyin을 허용합니다.
해당 결제수단 선택은 Agent를 통해 제공될 수 있으며, 선택된 결제 수단은 PaymentMethod 필드에 셋팅되어 Terminal로 전송됩니다.
단, CardPresent=”2”(MOTO)인 경우, 단말기 설정을 무시하고, Keyin을 허용합니다.
| 항목 | TYPE | LEN | 비고 |
|---|---|---|---|
| CardPresent | AN | 1 | 공백 |
| IsToken | AN | 1 | "N" |
| TrackData | AN | 66 | 공백 |
| IssuerId | AN | 4 | 공백 단, 은련카드 거래일 경우 "IS08" |
| Currency | AN | 3 | 통화 코드 "KRW" |
| Amount | N | 12 | 환불금액 KRW 10,000 → 10000 |
| OriginalTransactionNo | AN | 12 | 공백 |
| Date1 | N | 8 | 공백 |
| Date2 | N | 8 | 공백 |
| POS | AN | 3 | "pos" (소문자) |
| TransactionType | N | 2 | 거래 구분 (Header와 동일한 값 입력) "03" |
| SequenceNo | AN | 12 | POS 자체 Sequence No 없을 경우 0으로 채움 (000000000000) |
| VariableDataLength | N | 4 | "0000" |
| VariableData | AN | 데이터를 기재하지 않음 | |
| PaymentMethod | AN | 3 | 결제수단 |
| WalletIdEntryMode | AN | 2 | 공백 |
| WalletIdLength | N | 4 | "0000" |
| WalletId | AN | 데이터를 기재하지 않음 | |
| Skip Menu | AN | 4 | 공백 |
| AuthNo | AN | 12 | 원 승인번호 |
| AuthDate | N | 6 | YYMMDD (원거래 승인일자) |
Refund Transaction 응답
'Sale Transaction 응답'과 동일
호출
040434030000 NS 2507527289******030* 000000000000502200000002 000000000000 IS51AQ0113233110 0020250122132504 000000000000 00023147773 92394398 CRDKB국민카드 KB국민카드 000000001000N
| 항목 | TYPE | LEN | 비고 |
|---|---|---|---|
| OfflineFlag | AN | 1 | 오프라인 여부 ( Y / N ) |
| EntryMode | AN | 2 | 카드 입력 구분 |
| ExpiryDate | N | 4 | 유효기간 |
| PAN | AN | 19 | Masked PAN |
| SequenceNo | AN | 12 | SequenceNo |
| TransactionNo | AN | 18 | 거래고유번호 |
| Tip | N | 12 | 봉사료 |
| TransToken | AN | 30 | 공백 |
| IssuerId | AN | 4 | 발급사 코드 |
| AcquirerId | AN | 4 | 매입사 코드 |
| AuthCode | AN | 15 | 승인번호 |
| Installment | N | 2 | 00 : 일시불 |
| TransactionDate | N | 14 | YYYYMMDD24Hmiss |
| BillingCurrency | AN | 3 | 자국통화코드 |
| BillingAmount | N | 12 | 자국통화금액 |
| DCCExchangeRate | AN | 10 | 환율 해당 필드의 첫번째 자리는 환율의 소수점 자리 수를 입력하고 뒤에 환율 입력 EX) 환율 1.123456 일 때 필드 값은 61123456 |
| MerchantId | AN | 15 | 가맹점번호 |
| TerminalId | AN | 8 | 단말기번호 |
| APMCode | AN | 3 | 간편결제 코드 |
| APMName | AN | 20 | 간편결제 명 |
| PaymentMethod | AN | 3 | 결제수단 |
| IssuerName | AN | 20 | 발급사 명 |
| AcquirerName | AN | 20 | 매입사 명 |
| Amount | N | 12 | 승인 금액 KRW 10,000 → 10000 |
| SignFlag | AN | 1 | 서명 거래 유무 (Y / N) |
| ResultMessage | AN | 150 | 응답메세지 - 정상 거래(0000)일 때는 공백 - 그 외 오류 거래에 대해 VAN 사로부터 전달받은 응답메세지 또는 Agent 오류 메시지 전달 |