대사

거래 대사, 입금 대사, 입금 예정 대사 API로 세부 정보를 확인할 수 있습니다.

거래 대사

거래 대사는 가맹점 별 거래에 대한 데이터를 제공합니다.
5년 이내 거래 내역을 조회할 수 있으며, 한 번에 최대 7일까지 조회 가능합니다.

요청

curl --request POST 'https://api-test.eximbay.com/v1/reconciliation/transactions' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json' \
  --data '{
    "mid" : "C2FA1F5848",
    "from_date" : "20250703",
    "to_date" : "20250703"
}'

요청한 API가 실패하면 resmsg에러 메시지가 돌아옵니다.

응답

{
  "D" : [
    {
      "request_amount": "0.01",
      "trade_type": "T000",
      "mid": "C2FA1F5848",
      "request_currency": "USD",
      "transacton_id": "C2FA1F5848W0000090043751",
      "param3": "TEST",
      "trade_date": "20250703170638",
      "order_id": "20250703170242leslieToken1",
      "payment_method": "P174",
      "param1": "",
      "param2": ""
    },
    {
      "request_amount": "1.00",
      "trade_type": "T000",
      "mid": "C2FA1F5848",
      "request_currency": "USD",
      "transacton_id": "C2FA1F5848W0000090043063",
      "param3": "TEST",
      "trade_date": "20250703091324",
      "order_id": "20250702181946_4091",
      "payment_method": "P174",
      "param1": "",
      "param2": ""
    }
  ],
  "T" : {
    "total_count" : 2
  },
  "H" : {
    "from_date": "20250703",
    "to_date": "20250703",
    "request_date": "20250724"
  }
}

입금 대사

입금 대사는 정산 주기에 따라 입금에 대한 데이터를 제공합니다.
입금 일자 기준으로 조회하며, 입금일 기준 익일부터 조회 가능합니다.

요청

curl --request POST 'https://api-test.eximbay.com/v1/reconciliation/settlements' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json' \
  --data '{
   "mid" : "C2FA1F5848",
   "remittance_date" : "20210803"
}'

요청한 API가 실패하면 resmsg에러 메시지가 돌아옵니다.

응답

{
    "D": [
        {
            "approval_amount": "12.00",
            "billed_currency": "USD",
            "service_fee_supply_amount": "-0.48",
            "fee_supply_amount": "-0.30",
            "request_amount": "12.00",
            "billed_type": "A",
            "request_sub_amount_total": "11.14",
            "mid": "1113DA79FA",
            "billed_exchange_rate_amount": "12.00",
            "transaction_type": "S",
            "trade_date": "20201109085848",
            "billed_exchange_rate": "1186.870000",
            "fee_amount": "-0.30",
            "service_fee_vat_amount": "0",
            "fee_vat_amount": "-0.03",
            "trade_type": "N",
            "request_currency": "USD",
            "transacton_id": "1113DA79FA20201109000001",
            "approval_currency": "USD",
            "service_fee_amount": "-0.48",
            "order_id": "20201106091833"
        },
        {
            "approval_amount": "13.00",
            "billed_currency": "USD",
            "service_fee_supply_amount": "-0.52",
            "fee_supply_amount": "-0.30",
            "request_amount": "13.00",
            "billed_type": "A",
            "request_sub_amount_total": "12.10",
            "mid": "1113DA79FA",
            "billed_exchange_rate_amount": "13.00",
            "transaction_type": "S",
            "trade_date": "20201109085916",
            "billed_exchange_rate": "1186.870000",
            "fee_amount": "-0.30",
            "service_fee_vat_amount": "0",
            "fee_vat_amount": "-0.03",
            "trade_type": "N",
            "request_currency": "USD",
            "transacton_id": "1113DA79FA20201109000002",
            "approval_currency": "USD",
            "service_fee_amount": "-0.52",
            "order_id": "20201106091833"
        }
    ],
    "T": {
        "total_count": 2
    },
    "H": {
        "deposit_amount": "27582.00",
        "exchange_rate": "1186.8700000000",
        "deposit_currency": "KRW",
        "settle_date": "20201211",
        "vat_fee_amount": "-0.10",
        "version": "200",
        "remittance_date": "20210803",
        "settle_currency": "USD",
        "etc_vat_amount": "-0.06",
        "adjust_amount": "0.00",
        "settle_amount": "23.40",
        "request_date": "20250724",
        "remittance_amount": "23.24"
    }
}

입금 예정 대사

입금 예정 대사는 거래일 기준 2일전 데이터에 대한 정산 예정 금액 데이터를 제공합니다.
거래일 기준으로 조회하며, 거래일 기준 2일 이후부터 조회 가능합니다.

요청

curl --request POST 'https://api-test.eximbay.com/v1/reconciliation/expected-settlements' \
  --header 'Authorization: Basic dGVzdF8xODQ5NzA1QzY0MkMyMTdFMEIyRDo=' \
  --header 'Content-Type: application/json' \
  --data '{
    "mid" : "C2FA1F5848",
    "pre_remittance_date" : "20240723"
}'

요청한 API가 실패하면 resmsg에러 메시지가 돌아옵니다.

응답

{
    "D": [
        {
            "approval_amount": "1000.00",
            "billed_currency": "KRW",
            "service_fee_supply_amount": "-10.00",
            "fee_supply_amount": "0.00",
            "request_amount": "1000.00",
            "billed_type": "A",
            "request_sub_amount_total": "990.00",
            "mid": "14A61A9353",
            "billed_exchange_rate_amount": "1000.00",
            "transaction_type": "S",
            "trade_date": "20240723165140",
            "billed_exchange_rate": "00000000001.000000",
            "fee_amount": "0.00",
            "service_fee_vat_amount": "0.00",
            "fee_vat_amount": "0.00",
            "trade_type": "N",
            "request_currency": "KRW",
            "transacton_id": "14A61A9353W0000056429329",
            "approval_currency": "KRW",
            "service_fee_amount": "-10.00",
            "order_id": "20240723164148"
        },
        {
            "approval_amount": "1000.00",
            "billed_currency": "KRW",
            "service_fee_supply_amount": "-10.00",
            "fee_supply_amount": "0.00",
            "request_amount": "1000.00",
            "billed_type": "A",
            "request_sub_amount_total": "990.00",
            "mid": "14A61A9353",
            "billed_exchange_rate_amount": "1000.00",
            "transaction_type": "S",
            "trade_date": "20240723184302",
            "billed_exchange_rate": "00000000001.000000",
            "fee_amount": "0.00",
            "service_fee_vat_amount": "0.00",
            "fee_vat_amount": "0.00",
            "trade_type": "N",
            "request_currency": "KRW",
            "transacton_id": "14A61A9353W0000056429530",
            "approval_currency": "KRW",
            "service_fee_amount": "-10.00",
            "order_id": "20240723180151"
        }
    ],
    "T": {
        "total_count": 2
    },
    "H": {
        "settle_currency": "KRW",
        "pre_settle_date": "20240802",
        "pre_remittance_date": "20240723",
        "adjust_amount": "-2.00",
        "settle_amount": "1980.00",
        "request_date": "20250724",
        "remittance_amount": "1978.00",
        "version": "200"
    }
}