현금영수증 발행 상태 조회
발행이나 취소 요청에 사용한 Bolta-Client-Reference-Id로 처리 상태를 조회합니다. status로 성공과 실패를 판별하고, 실패 사유는 failure에서 확인하세요. LIVE 요청은 처리 중이거나 발행 결과 확인이 필요하면 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다.
curl --request GET \
--url https://xapi.bolta.io/v1/cashReceipts/status \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/cashReceipts/status"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://xapi.bolta.io/v1/cashReceipts/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://xapi.bolta.io/v1/cashReceipts/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://xapi.bolta.io/v1/cashReceipts/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/cashReceipts/status")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/cashReceipts/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"clientReferenceId": "<string>",
"issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
"type": "ISSUE",
"status": "PENDING",
"message": "<string>",
"originalIssuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
"cashReceiptApprovalNumber": "<string>",
"failure": {
"code": "<string>",
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
쿼리 매개변수
발행이나 취소 요청에 사용한 Bolta-Client-Reference-Id
1 - 255\S응답
현금영수증 발행 또는 취소 처리 상태
요청자 관리번호(Bolta-Client-Reference-Id)
현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으니 문자열 전체를 그대로 저장하세요.
"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
요청 유형. ISSUE: 발행, CANCELLATION: 취소
ISSUE, CANCELLATION 처리 상태. PENDING은 처리 시작 대기, REQUEST_SUCCESS는 요청 전달 완료이며 둘 다 최종 결과가 아닙니다. ISSUED, CANCELED는 성공이고 REQUEST_FAILURE, ISSUE_FAILED, CANCEL_FAILED는 실패입니다. EXTERNALLY_CANCELED는 볼타 외부에서 취소된 종료 상태입니다.
PENDING, REQUEST_SUCCESS, REQUEST_FAILURE, ISSUED, ISSUE_FAILED, CANCELED, CANCEL_FAILED, EXTERNALLY_CANCELED 처리 상태 안내 메시지. 최종 결과는 status와 failure로 판단하세요.
취소 요청의 원본 발행 식별 키
"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
발행 성공 시 제공하는 현금영수증 승인번호
실패 상태일 때 제공하는 실패 사유
Show child attributes
Show child attributes
curl --request GET \
--url https://xapi.bolta.io/v1/cashReceipts/status \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://xapi.bolta.io/v1/cashReceipts/status"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://xapi.bolta.io/v1/cashReceipts/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://xapi.bolta.io/v1/cashReceipts/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://xapi.bolta.io/v1/cashReceipts/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://xapi.bolta.io/v1/cashReceipts/status")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://xapi.bolta.io/v1/cashReceipts/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"clientReferenceId": "<string>",
"issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
"type": "ISSUE",
"status": "PENDING",
"message": "<string>",
"originalIssuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
"cashReceiptApprovalNumber": "<string>",
"failure": {
"code": "<string>",
"message": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}