CommonApiVersion 1.0.0

Check Orders

GEThttps://pay.globepay.co/api/v1.0/gateway/partners/{partner_code}/orders

Get a list of orders. This api may change in the future.

FieldDescription
Accept

application/json

Content-Type

application/json

Path Variable

FieldTypeDescription
partner_codeString

Required, Partner code

Query Params

FieldTypeDescription
dateString

Payment order creation date,which is formatted in 'yyyyMMdd' ,UTC+10. Query all orders if not provided

statusString

Order status

  • ALL: All orders, including orders not paid and closed
  • PAID: Only paid orders. including orders which have refunds.
  • REFUNDED: Only orders which have refunds

Default value: ALL

Allowed values: 'ALL', 'PAID', 'REFUNDED'

pageint

Page number. start with 1

Default value: 1

limitint

Rows per page

Default value: 10

timeLong

Required, UTC timestamp in milliseconds

nonce_strString

Required, Random string

signString

Required, Sign

ROOT

FieldTypeDescription
return_codeString

Execution result

dataJSON[]

Orders list

paginationJSON

Pagination information

analysisJSON

Payment analysis

data

FieldTypeDescription
channel_order_idString

Channel(such as Wechat、Alipay) Order Id

order_idString

GlobePay Order ID

partner_order_idString

Partner Order ID

total_feeint

Order amount

real_feeint

Actual paid amount

paymentString

via channel: Alipay, Wechat

currencyString

Currency

create_timeString

Time when order is created, which is formatted in 'yyyy-MM-dd HH:mm:ss', UTC+10

pay_timeString

Time when order is paid, which is formatted in 'yyyy-MM-dd HH:mm:ss', UTC+10. will be null if not paid

statusString

order status

  • SUBMITTING: Submitting to wechat
  • SUBMIT_FAIL: Submission failed
  • WAITING_PAYMENT: Submission succeeded and wait for payment
  • CLOSED: Order closed
  • PAYMENT_FAIL: Payment failed
  • SUCCESS: Payment succeeded
  • PARTIAL_REFUND: Partial Refunded
  • FULL_REFUND: Full Refunded
order_bodyString

Order description

gatewayString
  • Retail In-Store: Paid from official EFTPos or App
  • QRCODE: Paid from merchant static QR Code
  • Online API: Paid from QR Code API
  • WeChat HTML5: Paid from JSAPI
  • Retail API: Paid from Retail API
  • Mobile H5: Paid from H5 Api
partner_codeString

Partner code

partner_nameString

Partner name

refund_feeString

Total refund amount of this order

pagination

FieldTypeDescription
pageint

Page number,start with 1

limitint

Rows per page

totalCountint

Total rows

totalPagesint

Total pages

analysis

FieldTypeDescription
order_countint

Order count of successful payment (including orders which have refunds)

total_feeint

Total amount

real_feeint

Actual paid amount

ERROR

NameDescription
return_code

Error Code

return_msg

Error Description

Error Code

NameDescription
SYSTEMERROR

Exception inside system

INVALID_SHORT_ID

Partner code is invalid or there is no partner associated with this code

SIGN_TIMEOUT

Sign expired, the difference between time and the server time is more than 5 minutes

INVALID_SIGN

Invalid sign

PARAM_INVALID

Parameters are invalid. See return_msg for more details.

NOT_PERMITTED

Gateway payment permission has not been enabled for this partner

INVALID_CHANNEL

Channel name is not available, check the Capitalize

PCI DSS Compliant

Security & Compliance

  • PCI DSSPayment Card Industry Data Security Standard compliant
  • TLS 1.2+API accepts TLS 1.2 / 1.3 encrypted connections only
  • SHA-256Every API request must carry a SHA-256 signature

On this page