EXIMBAY 개발자센터

신용결제승인-요청

SEND 010010

신용결제승인 전문 구분

Operation ID신용결제승인-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

신용결제승인 요청msg.010010.send

Message IDmsg.010010.send

Payload

object

전문내용

priceAmt

required

number

승인 금액

taxAmt

number

부가세 금액

tipAmt

number

봉사료 금액

taxFreeAmt

number

비과세 금액

installment

number

[T650P 단독사용] 할부 개월 (일시불 0)

ptxid

string

결제고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999010010"

Examples

Payload

{
  "priceAmt": 0,
  "taxAmt": 0,
  "tipAmt": 0,
  "taxFreeAmt": 0,
  "installment": 0,
  "ptxid": "string"
  }

This example has been generated automatically.

Headers

신용결제승인-응답

RECEIVE 010010

Operation ID신용결제승인-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

신용결제승인 응답msg.010010.recv

Message IDmsg.010010.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

merchantCode

string

가맹점 번호

installment

number

할부개월

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 카드번호(마스킹 처리)

issuerCode

string

발급사코드

issuerName

string

발급사

acquirerCode

string

매입사코드

acquirerName

string

매입사

transactionDate

string

승인일시

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999010010"

Examples

Payload

{
  "resultCode": "string",
  "resultMessage": "string",
  "data": {
    "approvalNo": "string",
    "transactionNo": "string",
    "merchantCode": "string",
    "installment": 0,
    "approvalAmt": 0,
    "tipAmt": 0,
    "taxAmt": 0,
    "taxFreeAmt": 0,
    "maskedTrackData": "string",
    "issuerCode": "string",
    "issuerName": "string",
    "acquirerCode": "string",
    "acquirerName": "string",
    "transactionDate": "string",
    "ptxid": "string"
    }
  }

This example has been generated automatically.

Headers

신용결제취소-요청

SEND 010020

신용결제취소 전문 구분

Operation ID신용결제취소-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

신용결제취소 요청 msg.010020.send

Message IDmsg.010020.send

Payload

object

전문내용

approvalAmt

required

number

승인 금액

approvalNo

required

string

결제승인번호

transactionDate

required

string

format: yyMMddHHmmsss

승인일자

transactionNo

required

string

[T650P 단독사용] 거래고유번호

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999010020"

Examples

Payload

{
      "approvalAmt": 0,
      "approvalNo": "string",
      "transactionDate": "string",
      "transactionNo": "string",
      "ptxid": "string"
    }

This example has been generated automatically.

Headers

신용결제취소-응답

RECEIVE 010020

Operation ID신용결제취소-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

신용결제취소 응답msg.010020.recv

Message IDmsg.010020.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

merchantCode

string

가맹점 번호

installment

number

할부개월

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 카드번호(마스킹 처리)

issuerCode

string

발급사코드

issuerName

string

발급사

acquirerCode

string

매입사코드

acquirerName

string

매입사

transactionDate

string

승인일시

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999010020"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "data": {
            "approvalNo": "string",
            "transactionNo": "string",
            "merchantCode": "string",
            "installment": 0,
            "approvalAmt": 0,
            "tipAmt": 0,
            "taxAmt": 0,
            "taxFreeAmt": 0,
            "maskedTrackData": "string",
            "issuerCode": "string",
            "issuerName": "string",
            "acquirerCode": "string",
            "acquirerName": "string",
            "transactionDate": "string",
            "ptxid": "string"
          }
        }

This example has been generated automatically.

Headers

서명대기-응답

RECEIVE 010010, 010020

서명이 필요한 거래의 경우 서버로부터 해당 전문을 받습니다. 신용승인 및 신용취소 요청 이후 해당되는 전문 구분과 응답코드 '0010' 가 전송 됩니다. 서명 프로세스 관련 별도 처리가 필요한 경우 해당 코드를 전송받은 후 처리하세요.

Operation ID서명대기-응답

Available only on servers:

T650P

Accepts the following message:

서명대기 응답msg.910090.recv

Message IDmsg.910090.recv

Payload

object

전문내용

resultCode

string

default: 0010

resultMessage

string

결과 메시지

data

object

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"신용결제승인"
"신용결제취소"

"0050010010"
"0050010020"

Examples

Payload

#1 Example - 단말기 서명화면 전환시

전환시 연동된 클라이언트로 아래 코드를 전송하여 서명이 필요한 상태임을 전송
```
{
          "resultCode": "0010",
          "resultMessage": "서명대기",
          "data": {
            "ptxid": "string"
          }
        }
        
```
#2 Example - 단말기 서명화면 전환 후 제한시간 초과시(30초)

서명대기 제한시간 초과로 요청한 전문(010010 or 010020)에 대한 실패 응답 전송
```
{
          "resultCode": "9999",
          "resultMessage": "서명시간초과",
          "data": {
            "ptxid": "string"
          }
        }
        
```

Headers

카드리딩취소-요청

SEND 910021

신용카드리딩취소 전문 구분

Operation ID카드리딩취소-요청

Available only on servers:

T650P

Accepts the following message:

리딩취소 요청msg.9x0021.send

Message IDmsg.9x0021.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"현금영수증리딩취소"

"0006910021"
"0006930021"
"0006970021"

Examples

Headers

카드리딩취소-응답

RECEIVE 910021

Operation ID카드리딩취소-응답

Available only on servers:

T650P

Accepts the following message:

리딩취소 응답msg.9x0021.recv

Message IDmsg.9x0021.recv

Payload

object

전문내용

resultCode

string

결과코드

*9991: 단말기에서 리딩취소를 처리 불가한 상태

*9999: 단말기에서 전문 처리가 불가한 상태

resultMessage

string

결과 메시지

data

object

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"현금영수증리딩취소"

"0050910021"
"0050930021"
"0050970021"

Examples

Payload

#1 Example - 리딩 취소 성공

리딩취소 요청 후 단말기에서 정상적으로 리딩취소 처리

{
          "resultCode": "0000",
          "resultMessage": "완료",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

#2 Example - 리딩 취소 실패

리딩취소 요청했으나 단말기에서 처리 불가한 상태

{
          "resultCode": "9991",
          "resultMessage": "unable to proceed",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

Headers

간편결제승인-요청

SEND 030010

간편결제승인 전문 구분

Operation ID간편결제승인-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

간편결제승인 요청msg.030010.send

Message IDmsg.030010.send

Payload

object

전문내용

serviceCode

required

string

서비스코드-국내통합 간편결제 'QRD' 로 고정

priceAmt

required

number

승인 금액

taxAmt

number

부가세 금액

tipAmt

number

봉사료 금액

taxFreeAmt

number

비과세 금액

installment

number

[T650P 단독사용] 할부 개월 (일시불 0)

ptxid

string

결제고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100030010"

Examples

Payload

#1 Example

{
          "serviceCode": "QRD",
          "priceAmt": 0,
          "taxAmt": 0,
          "tipAmt": 0,
          "taxFreeAmt": 0,
          "installment": 0,
          "ptxid": "string"
        }

Headers

간편결제승인-응답

RECEIVE 030010

Operation ID간편결제승인-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

간편결제승인 응답msg.030010.recv

Message IDmsg.030010.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

merchantCode

string

가맹점 번호

installment

number

할부개월

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 카드번호(마스킹 처리)

issuerCode

string

발급사코드

issuerName

string

발급사

acquirerCode

string

매입사코드

acquirerName

string

매입사

transactionDate

string

승인일시

pointAmt1

number

발생포인트/할인금액

pointAmt2

number

가용포인트/지불금액

pointAmt3

number

누적포인트/잔액한도

serviceCode

string

서비스코드

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100030010"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "data": {
            "approvalNo": "string",
            "transactionNo": "string",
            "merchantCode": "string",
            "installment": 0,
            "approvalAmt": 0,
            "tipAmt": 0,
            "taxAmt": 0,
            "taxFreeAmt": 0,
            "maskedTrackData": "string",
            "issuerCode": "string",
            "issuerName": "string",
            "acquirerCode": "string",
            "acquirerName": "string",
            "transactionDate": "string",
            "pointAmt1": 0,
            "pointAmt2": 0,
            "pointAmt3": 0,
            "serviceCode": "string",
            "ptxid": "string"
          }
        }

This example has been generated automatically.

Headers

간편결제취소-요청

SEND 030020

간편결제취소 전문 구분

Operation ID간편결제취소-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

간편결제승인 요청msg.030020.send

Message IDmsg.030020.send

Payload

object

전문내용

approvalAmt

required

number

승인 금액

approvalNo

required

string

결제승인번호

transactionDate

required

string

format: yyMMddHHmmsss

승인일자

transactionNo

required

string

[T650P 단독사용] 거래고유번호

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100030020"

Examples

Payload

{
          "approvalAmt": 0,
          "approvalNo": "string",
          "transactionDate": "string",
          "transactionNo": "string",
          "ptxid": "string"
        }

This example has been generated automatically.

Headers

간편결제취소-응답

RECEIVE 030020

Operation ID간편결제취소-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

간편결제취소 응답msg.030020.recv

Message IDmsg.030020.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

merchantCode

string

가맹점 번호

installment

number

할부개월

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 카드번호(마스킹 처리)

issuerCode

string

발급사코드

issuerName

string

발급사

acquirerCode

string

매입사코드

acquirerName

string

매입사

transactionDate

string

승인일시

pointAmt1

number

발생포인트/할인금액

pointAmt2

number

가용포인트/지불금액

pointAmt3

number

누적포인트/잔액한도

serviceCode

string

서비스코드

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100030020"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "data": {
            "approvalNo": "string",
            "transactionNo": "string",
            "merchantCode": "string",
            "installment": 0,
            "approvalAmt": 0,
            "tipAmt": 0,
            "taxAmt": 0,
            "taxFreeAmt": 0,
            "maskedTrackData": "string",
            "issuerCode": "string",
            "issuerName": "string",
            "acquirerCode": "string",
            "acquirerName": "string",
            "transactionDate": "string",
            "pointAmt1": 0,
            "pointAmt2": 0,
            "pointAmt3": 0,
            "serviceCode": "string",
            "ptxid": "string"
          }
        }

This example has been generated automatically.

Headers

간편결제리딩취소-요청

SEND 930021

간편결제리딩취소 전문 구분

Operation ID간편결제리딩취소-요청

Available only on servers:

T650P

Accepts the following message:

리딩취소 요청msg.9x0021.send

Message IDmsg.9x0021.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"현금영수증리딩취소"

"0006910021"
"0006930021"
"0006970021"

Examples

Headers

간편결제리딩취소-응답

RECEIVE 930021

Operation ID간편결제리딩취소-응답

Available only on servers:

T650P

Accepts the following message:

리딩취소 응답msg.9x0021.recv

Message IDmsg.9x0021.recv

Payload

object

전문내용

resultCode

string

결과코드

*9991: 단말기에서 리딩취소를 처리 불가한 상태

*9999: 단말기에서 전문 처리가 불가한 상태

resultMessage

string

결과 메시지

data

object

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"간편결제리딩취소"

"0050910021"
"0050930021"
"0050930021"

Examples

Payload

#1 Example - 리딩 취소 성공

리딩취소 요청 후 단말기에서 정상적으로 리딩취소 처리

{
          "resultCode": "0000",
          "resultMessage": "완료",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

#2 Example - 리딩 취소 실패

리딩취소 요청했으나 단말기에서 처리 불가한 상태

{
          "resultCode": "9991",
          "resultMessage": "unable to proceed",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

Headers

현금영수증발급-요청

SEND 070010

현금영수증발급 전문 구분

Operation ID현금영수증발급-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

현금영수증발급 요청msg.070010.send

Message IDmsg.070010.send

Payload

object

전문내용

priceAmt

required

number

승인 금액

taxAmt

number

부가세 금액

tipAmt

number

봉사료 금액

taxFreeAmt

number

비과세 금액

traderType

required

number

현금영수증 발급 타입

소비자 소득공제
사업자 지출증빙
자진발급

"1"
"2"
"3"

approvalNumber

string

[T650P 단독사용] 휴대폰번호 or 사업자번호

미입력시 EximPay 앱의 발급번호 입력 화면으로 이동

ptxid

string

결제고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100070010"

Examples

Payload

{
          "priceAmt": 0,
          "taxAmt": 0,
          "tipAmt": 0,
          "taxFreeAmt": 0,
          "traderType": "1",
          "approvalNumber": "string",
          "ptxid": "string"
        }

This example has been generated automatically.

Headers

현금영수증발급-응답

RECEIVE 070010

Operation ID현금영수증발급-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

현금영수증발급 응답msg.070010.recv

Message IDmsg.070010.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 카드번호(마스킹 처리)

transactionDate

string

승인일시

receiptTitle

string

전표타이틀

traderType

string

현금영수증 발급 타입

소비자 소득공제
사업자 지출증빙
자진발급

"1"
"2"
"3"

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100070010"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "data": {
            "approvalNo": "string",
            "transactionNo": "string",
            "approvalAmt": 0,
            "tipAmt": 0,
            "taxAmt": 0,
            "taxFreeAmt": 0,
            "maskedTrackData": "string",
            "transactionDate": "string",
            "receiptTitle": "string",
            "traderType": "1",
            "ptxid": "string"
          }
        }

This example has been generated automatically.

Headers

현금영수증취소-요청

SEND 070020

현금영수증취소 전문 구분

Operation ID현금영수증취소-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

현금영수증취소 요청 msg.070020.send

Message IDmsg.070020.send

Payload

object

전문내용

approvalAmt

required

number

승인 금액

approvalNo

required

string

결제승인번호

transactionDate

required

string

format: yyMMddHHmmsss

승인일자

transactionNo

required

string

[T650P 단독사용] 거래고유번호

traderType

required

string

현금영수증 발급 타입

소비자 소득공제
사업자 지출증빙
자진발급

"1"
"2"
"3"

approvalNumber

string

[T650P 단독사용] 발급시 입력한 휴대폰번호 or 사업자번호

미입력시 EximPay 앱의 발급번호 입력 화면으로 이동

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100070020"

Examples

Payload

{
          "approvalAmt": 0,
          "approvalNo": "string",
          "transactionDate": "string",
          "transactionNo": "string",
          "traderType": "1",
          "approvalNumber": "string",
          "ptxid": "string"
        }

This example has been generated automatically.

Headers

현금영수증취소-응답

RECEIVE 070020

Operation ID현금영수증취소-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

현금영수증취소 응답msg.070020.recv

Message IDmsg.070020.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과 메시지

data

object

approvalNo

string

결제승인번호

transactionNo

string

거래고유번호

approvalAmt

number

승인금액

tipAmt

number

봉사료 금액

taxAmt

number

부가세 금액

taxFreeAmt

number

비과세 금액

maskedTrackData

string

영수증 출력용 현금영수증 발행번호(마스킹 처리)

transactionDate

string

승인일시

receiptTitle

string

전표타이틀

traderType

string

현금영수증 발급 타입

소비자 소득공제
사업자 지출증빙
자진발급

"1"
"2"
"3"

ptxid

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0100070020"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "data": {
            "approvalNo": "string",
            "transactionNo": "string",
            "approvalAmt": 0,
            "tipAmt": 0,
            "taxAmt": 0,
            "taxFreeAmt": 0,
            "maskedTrackData": "string",
            "transactionDate": "string",
            "receiptTitle": "string",
            "traderType": "1",
            "ptxid": "string"
          }
        }

This example has been generated automatically.

Headers

현금영수증리딩취소-요청

SEND 970021

현금영수증리딩취소 전문 구분

Operation ID현금영수증리딩취소-요청

Available only on servers:

T650P

Accepts the following message:

리딩취소 요청msg.9x0021.send

Message IDmsg.9x0021.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"현금영수증리딩취소"

"0006910021"
"0006930021"
"0006970021"

Examples

Headers

현금영수증리딩취소-응답

RECEIVE 970021

Operation ID현금영수증리딩취소-응답

Available only on servers:

T650P

Accepts the following message:

리딩취소 응답msg.9x0021.recv

Message IDmsg.9x0021.recv

Payload

object

전문내용

resultCode

string

결과코드

*9991: 단말기에서 리딩취소를 처리 불가한 상태

*9999: 단말기에서 전문 처리가 불가한 상태

resultMessage

string

결과 메시지

data

object

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"카드리딩취소"
"간편결제리딩취소"
"현금영수증리딩취소"

"0050910021"
"0050930021"
"0050970021"

Examples

Payload

#1 Example - 리딩 취소 성공

리딩취소 요청 후 단말기에서 정상적으로 리딩취소 처리

{
          "resultCode": "0000",
          "resultMessage": "완료",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

#2 Example - 리딩 취소 실패

리딩취소 요청했으나 단말기에서 처리 불가한 상태

{
          "resultCode": "9991",
          "resultMessage": "unable to proceed",
          "data": {
            "ptxid": "CPOS-c1e02447-50ad-4823-b505-eab86dfbfd1a"
          }
        }

Headers

직전거래조회-요청

SEND 990001

직전거래조회 전문 구분

Operation ID직전거래조회-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

직전거래조회 요청msg.990001.send

Message IDmsg.990001.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"0006990001"

Examples

Headers

직전거래조회-응답

RECEIVE 990001

Operation ID직전거래조회-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

직전거래조회 응답msg.990001.recv

Message IDmsg.990001.recv

Payload

object

format: 직전거래 타입별 응답 포맷

전문내용 (직전거래구분에 따라 응답 포맷이 다름. 각 응답 포맷 확인 요망)

Headers

string

전문길이 + 전문구분

"0500990001"

Examples

Payload

{}

This example has been generated automatically.

Headers

매출집계조회-요청

SEND 050099

매출집계조회 전문 구분

Operation ID매출집계조회-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

매출집계조회 요청msg.050099.send

Message IDmsg.050099.send

Payload

object

전문내용

Headers

string

전문길이 + 전문구분

"0050050099"

Examples

Payload

{
          "from": "20240101",
          "to": "20241231"
        }

This example has been generated automatically.

Headers

매출집계조회-응답

RECEIVE 050099

Operation ID매출집계조회-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

매출집계조회 응답msg.050099.recv

Message IDmsg.050099.recv

Payload

object

전문내용

resultCode

string

조회 시작 날짜

resultMessage

string

조회 종료 날짜

period

string

조회 기간(from-to)

data

object

approved

object

승인거래내역

count

number

거래 건수

price

number

총 금액

issuer

number

발급사

Additional properties are allowed.

canceled

object

취소거래내역

count

number

거래 건수

price

number

총 금액

issuer

number

발급사

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"0500050099"

Examples

Payload

{
          "resultCode": "string",
          "resultMessage": "string",
          "period": "string",
          "data": {
            "approved": {
              "count": 0,
              "price": 0,
              "issuer": 0
            },
            "canceled": {
              "count": 0,
              "price": 0,
              "issuer": 0
            }
          }
        }

This example has been generated automatically.

Headers

결제결과확인-요청

SEND 980001

결제결과확인 전문 구분

전문처리(승인/취소) 후 응답 수신이 완료되었는지 교차검증을 위한 전문 입니다. 거래관련 전문에 대한 응답을 받은 경우 해당 전문을 호출합니다. 해당 전문 교환을 통해 단말기(서버) 는 응답 교환이 정상적으로 이루어졌음을 판단합니다.

Operation ID결제결과확인-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

결제결과확인 요청msg.980001.send

Message IDmsg.980001.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"0006980001"

Examples

Headers

결제결과확인-응답

RECEIVE 980001

Operation ID결제결과확인-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

결제결과확인 응답msg.980001.recv

Message IDmsg.980001.recv

Payload

object

전문내용

Headers

string

전문길이 + 전문구분

"9999980001"

Examples

Payload

#1 Example

{
            "resultCode": "0000",
            "resultMessage": "end of transmission"
          }

Headers

코드다운로드-요청

SEND 081008

코드다운로드 전문 구분

Operation ID코드다운로드-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

코드다운로드 요청msg.081008.send

Message IDmsg.081008.send

전문내용 불필요하며, 헤더만 전송됩니다.

Headers

string

전문길이 + 전문구분

"0006081008"

Examples

Headers

코드다운로드-응답

RECEIVE 081008

Operation ID코드다운로드-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

코드다운로드 응답msg.081008.recv

Message IDmsg.081008.recv

전문내용

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과메시지

data

object

totalCount

number

총 코드

codeList

array<any>

code

string

코드

codeName

string

코드명

groupCode

string

그룹코드

groupCodeName

string

그룹코드명

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999081008"

Examples

Payload

#1 Example

{
          "resultCode": "0000",
          "resultMessage": "코드리스트 정상 조회",
          "data": {
            "totalCount": 0,
            "codeList": [
              {
                "code": "AQ15",
                "codeName": "KT 포인트",
                "groupCode": "AG04",
                "groupCodeName": "국내포인트결제매입사"
              },
              {
                "code": "AQ16",
                "codeName": "LG 포인트",
                "groupCode": "AG04",
                "groupCodeName": "국내포인트결제매입사"
              },
              {
                "code": "CASH",
                "codeName": "현금영수증",
                "groupCode": "",
                "groupCodeName": ""
              }
            ]
          }
        }

Headers

프린트출력-요청

SEND 900091

프린트출력 전문 구분

Operation ID프린트출력-요청

Available only on servers:

T650P

Accepts the following message:

프린트출력 요청msg.900091.send

Message IDmsg.900091.send

Payload

object

전문내용

fontFamily

string

폰트타입

(Nullable) default: NanumBarunGothic

"NanumBarunGothic"
"Noto Sans Korean"

alert

boolean

출력시 알림음 재생

continuePrint

boolean

이어서 출력 여부

*true: 이어서 출력을 진행하기 위해 마지막 여분의 개행을 하지 않습니다. *false: 이어서 출력하지 않는 경우 절취를 위해 여분의 개행을 추가합니다.

commands

required

array<any>

fontSize

number

폰트 사이즈

command

required

string

프린트 명령어

*line: 라인 추가

*cuttingLine: 절취선 추가

*barcode: Code128 바코드 생성

*br: 빈줄 개행

*left: Text 좌측정렬(message size:1)

*right: Text 우측정렬(message size:1)

*center: Text 중앙정렬(message size:1)

*text2: Text 양끝 정렬(message size:2)

*text3 Text 3열 정렬(message size:3)

"line"
"cuttingLine"
"barcode"
"br"
"left"
"right"
"center"
"text2"
"text3"

message

array<string>

Text 관련 command 사용시 필수. 텍스트 배치 순서는 배열 순서와 같습니다. (message size 참고)

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999900091"

Examples

Payload

#1 Example

{
          "fontFamily": "Noto Sans Korean",
          "alert": true,
          "commands": [
            {
              "command": "logo"
            },
            {
              "command": "line"
            },
            {
              "command": "cuttingLine"
            },
            {
              "command": "br"
            },
            {
              "command": "left",
              "fontSize": 20,
              "message": [
                "left test 20px"
              ]
            },
            {
              "command": "right",
              "fontSize": 20,
              "message": [
                "right test 20px"
              ]
            },
            {
              "command": "text2",
              "fontSize": 10,
              "message": [
                "one",
                "two"
              ]
            },
            {
              "command": "text3",
              "fontSize": 10,
              "message": [
                "one",
                "two",
                "three"
              ]
            }
          ]
        }

Headers

프린트출력-응답

RECEIVE 900091

Operation ID프린트출력-응답

Available only on servers:

T650P
P3MIX

Accepts the following message:

프린트출력 응답msg.900091.recv

Message IDmsg.900091.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과메시지

*9951: 프린트 용지 확인

*9952: 프린터 커버 확인

*9953: 프린트 용지 정리

*9954: 프린터 과열

*9955: 프린터 연결 확인

*9956: 프린터 전원 확인

*9959: Unknown error

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999900091"

Examples

Payload

#1 Example

{
          "resultCode": "0000",
          "resultMessage": "프린트 정상 출력"
        }

Headers

환급전표발행(T650P)-요청

SEND 050010

환급전표발행(T650P) 전문 구분

Operation ID환급전표발행(T650P)-요청

Available only on servers:

T650P

Accepts the following message:

환급전표발행(T650P) 요청msg.050010-t650p.send

Message IDmsg.050010-t650p.send

Payload

object

전문내용

taxRefundMode

required

string

환급방식

*post: 사후환급

*instant: 즉시환급

*offline: 오프라인

"post"
"instant"
"offline"

paymentType

required

string

결제방식

*card: 신용결제

*qr: 간편결제

*cash: 현금결제

"card"
"qr"
"cash"

approvalAmt

required

number

승인금액

salesSerial

number

결제 승인건에 대한 거래고유번호(transactionNo)

qrServiceCode

string

QR 서비스 코드(거래구분: 간편결제 시 필수입력)

ptxId

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999050010"

Examples

Payload

{
          "taxRefundMode": "post",
          "paymentType": "card",
          "approvalAmt": 0,
          "salesSerial": 0,
          "qrServiceCode": "string",
          "ptxId": "string"
        }

This example has been generated automatically.

Headers

환급전표발행(P3MIX)-요청

SEND 050010

환급전표발행(P3MIX) 전문 구분

Operation ID환급전표발행(P3MIX)-요청

Available only on servers:

P3MIX

Accepts the following message:

환급전표발행(P3MIX) 요청msg.050010-p3mix.send

Message IDmsg.050010-p3mix.send

Payload

object

가맹점 용역 유형별 요청 파라미터 상이하므로, 유형별 요청 파라미터 확인 바랍니다(Examples).

Example1 : 의료환급전표 요청 파라미터

Exmaple2 : 물품환급전표 요청 파라미터

Exmaple3 : 호텔환급전표 요청 파라미터

모든 파라미터는 Optional 이며, 입력된 정보에 한해 결제단말기 부가세환급 프로세스 단계에서 매핑됩니다. (각 유형별 요구되는 파라미터 이외 불필요한 파라미터 입력시 무시)

의료환급요청

object

cardAmount

number

카드결제금액

cashAmount

number

현금결제금액

etcAmount

number

기타결제금액(간편결제 등)

salesSerial

string

거래고유번호(= transactionNo)

taxRefundSerial

string

환급전표발행번호

Additional properties are allowed.

물품환급요청

object

호텔환급요청

object

checkIn

string

체크인 일자

checkOut

string

체크아웃 일자

salesSerial

string

거래고유번호(= transactionNo)

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999050010"

Examples

Payload

#1 Example

{
  "cardAmount": 50000,
  "cashAmount": 0,
  "etcAmount": 0,
  "salesSerial": "salesSerial or transactionNo",
  "facilitatorNumber": "0000000000"
  }

#2 Example

{
  "salesSerial": "salesSerial or transactionNo"
}

#3 Example

{
  "checkIn": "240101",
  "checkOut": "241231",
  "salesSerial": "salesSerial or transactionNo"
}

Headers

환급전표취소-요청

SEND 050020

환급전표취소 전문 구분

Operation ID환급전표취소-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

환급전표취소 요청msg.050020.send

Message IDmsg.050020.send

Payload

object

전문내용

taxRefundSerial

required

string

환급전표 발행번호

isPrint

required

boolean

[T650P 단독사용] 프린트 여부 (true: 조회 성공시 환급 영수증 출력)

ptxId

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999050020"

Examples

Payload

#1 Example

{
          "taxRefundSerial": "80103750224020100017",
          "isPrint": "true",
          "ptxId": "abcd-efgcg-asdd-dawdad-dadw"
        }

Headers

환급전표조회-요청

SEND 900050

환급전표조회 전문 구분

Operation ID환급전표조회-요청

Available only on servers:

T650P
P3MIX

Accepts the following message:

환급전표취소 요청msg.050020.send

Message IDmsg.050020.send

Payload

object

전문내용

taxRefundSerial

required

string

환급전표 발행번호

isPrint

required

boolean

[T650P 단독사용] 프린트 여부 (true: 조회 성공시 환급 영수증 출력)

ptxId

string

전문고유번호

클라이언트 측에서 전문 구분을 위해 직접 발행하는 데이터로서, 결제앱과는 무관함

Additional properties are allowed.

Headers

string

전문길이 + 전문구분

"9999050020"

Examples

Payload

#1 Example

{
          "taxRefundSerial": "80103750224020100017",
          "isPrint": "true",
          "ptxId": "abcd-efgcg-asdd-dawdad-dadw"
        }

Headers

환급전표응답

RECEIVE 050010, 050020, 900050

GI-부가세환급 전표 응답

Operation ID환급전표응답

Available only on servers:

T650P
P3MIX

Accepts one of the following messages:

#0환급전표취소 응답 - 물품 & 호텔msg.gi-product-hotel.recv

Message IDmsg.gi-product-hotel.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과메시지

data

object

buyerCountry

string

구매자 국가

buyerName

string

구매자 이름

dutyFreeStoreNumber

string

면세점 번호

message0

string

응답 메시지(에러시)

message1

string

메시지 1

message2

string

메시지 2

message3

string

물품 정보

passportSerial

string

전표 출력용 여권정보

refundBalance

number

환금액

refundDate

string

환급전표 발행날짜

refundTime

string

환급전표 발행시간

refundSerial

string

환급전표 시리얼

taxrefundSerial

string

환급전표 발행번호

Additional properties are allowed.

Additional properties are allowed.
Headers

string

전문길이 + 전문구분

Allowed values:
"환급전표발행"

"환급전표취소"

"환급전표조회"

Examples values:
"9999050010"

"9999050020"

"9999900050"
Examples
Payload

{ "resultCode": "string", "resultMessage": "string", "data": { "buyerCountry": "string", "buyerName": "string", "dutyFreeStoreNumber": "string", "message0": "string", "message1": "string", "message2": "string", "message3": "string", "passportSerial": "string", "refundBalance": 0, "refundDate": "string", "refundTime": "string", "refundSerial": "string", "taxrefundSerial": "string" } }

This example has been generated automatically.
Headers

#1 Example

9999050010

#1 Example

9999050020

#1 Example

9999900050
#1환급전표취소 응답 - 의료msg.gi-medical.recv

Message IDmsg.gi-medical.recv

Payload

object

전문내용

resultCode

string

결과코드

resultMessage

string

결과메시지

data

object

buyerCountry

string

구매자 국가

buyerName

string

구매자 이름

cardAmount

number

카드결제금액

cashAmount

number

현금결제금액

etcAmount

number

기타결제금액

facilitatorBusinessSerial

string

유치업자 사업자번호

facilitatorMedicalSerial

string

유치의료기관 등록번호

facilitatorName

string

유치업자명

facilitatorSerial

string

유치업자 등록번호

passportSerial

string

여권정보

price

number

총 구매금액

refundBalance

number

환급액

refundDate

string

환급전표 발행날짜

refundTime

string

환급전표 발행시간

refundSerial

string

환금전표 시리얼

resCode

string

응답 코드

resMessage

string

응답 메시지

resMessageTaxrefund

string

부가세환급 응답 메시지

Additional properties are allowed.

Additional properties are allowed.
Headers

string

XXXX050020

Allowed values:
"환급전표발행"

"환급전표취소"

"환급전표조회"

Examples values:
"9999050010"

"9999050020"

"9999900050"
Examples
Payload

{ "resultCode": "string", "resultMessage": "string", "data": { "buyerCountry": "string", "buyerName": "string", "cardAmount": 0, "cashAmount": 0, "etcAmount": 0, "facilitatorBusinessSerial": "string", "facilitatorMedicalSerial": "string", "facilitatorName": "string", "facilitatorSerial": "string", "passportSerial": "string", "price": 0, "refundBalance": 0, "refundDate": "string", "refundTime": "string", "refundSerial": "string", "resCode": "string", "resMessage": "string", "resMessageTaxrefund": "string" } }

This example has been generated automatically.
Headers

#1 Example

9999050010

#1 Example

9999050020

#1 Example

9999900050

실행취소-요청

SEND 555555

클라이언트(POS) 에서 요청에 대한 실행을 취소하고자 할때 사용

Operation ID실행취소-요청

Available only on servers:

P3MIX

Accepts the following message:

실행취소 요청msg.555555.send

Message IDmsg.555555.send

전문내용 불필요하며, 헤더만 전송됩니다

Headers

string

전문길이 + 전문구분

"0006555555"

Examples

Headers

실행취소-응답

RECEIVE 555555

Operation ID실행취소-응답

Available only on servers:

P3MIX

Accepts one of the following messages:

#0실행취소 완료msg.555555-done.recv

Message IDmsg.555555-done.recv

결제단말기(서버) 에서 진행중인 작업 취소 완료

Payload

object

resultCode

string

결과코드

resultMessage

string

결과 메시지

Additional properties are allowed.
Headers

string

전문길이 + 전문구분

Examples values:
"XXXX555555"
Examples
Payload

#1 Example

{ "resultCode": "9999", "resultMessage": "사용자 취소" }
Headers

#1 Example

XXXX555555
#1실행취소 불가msg.555555-reject.recv

Message IDmsg.555555-reject.recv

결제단말기(서버) 작업 취소 불가 (이미 결제진행중 또는 기타 작업을 취소할 수 없는 상태인 경우)

Payload

object

resultCode

string

결과코드

resultMessage

string

결과 메시지

Additional properties are allowed.
Headers

string

전문길이 + 전문구분

Examples values:
"XXXX555555"
Examples
Payload

#1 Example

{ "resultCode": "0001", "resultMessage": "처리중 입니다. 작업을 취소할 수 없습니다." }
Headers

#1 Example

XXXX555555

Operations

신용결제승인-요청

SEND 010010

Examples

This example has been generated automatically.

#1 Example

신용결제승인-응답

RECEIVE 010010

Examples

This example has been generated automatically.

#1 Example

신용결제취소-요청

SEND 010020

Examples

This example has been generated automatically.

#1 Example

신용결제취소-응답

RECEIVE 010020

Examples

This example has been generated automatically.

#1 Example

서명대기-응답

RECEIVE 010010, 010020

Examples

#1 Example - 단말기 서명화면 전환시

#2 Example - 단말기 서명화면 전환 후 제한시간 초과시(30초)

#1 Example

#2 Example

카드리딩취소-요청

SEND 910021

Examples

#1 Example

#2 Example

#3 Example

카드리딩취소-응답

RECEIVE 910021

Examples

#1 Example - 리딩 취소 성공

#2 Example - 리딩 취소 실패

#1 Example

#2 Example

#3 Example

간편결제승인-요청

SEND 030010

Examples

#1 Example { "serviceCode": "QRD", "priceAmt": 0, "taxAmt": 0, "tipAmt": 0, "taxFreeAmt": 0, "installment": 0, "ptxid": "string" }

#1 Example

간편결제승인-응답

RECEIVE 030010

Examples

This example has been generated automatically.

#1 Example

간편결제취소-요청

SEND 030020

Examples

This example has been generated automatically.

#1 Example

간편결제취소-응답

RECEIVE 030020

Examples

This example has been generated automatically.

#1 Example

간편결제리딩취소-요청

SEND 930021

Examples

#1 Example

#1 Example

#1 Example

간편결제리딩취소-응답

RECEIVE 930021

Examples

#1 Example - 리딩 취소 성공

#2 Example - 리딩 취소 실패

#1 Example

#2 Example

#3 Example

현금영수증발급-요청

SEND 070010

Examples

This example has been generated automatically.

#1 Example

`{ "serviceCode": "QRD", "priceAmt": 0, "taxAmt": 0, "tipAmt": 0, "taxFreeAmt": 0, "installment": 0, "ptxid": "string" }`