UnionPayOnlineVersion 1.0.0

Create a UnionPay Online Order

PUThttps://pay.globepay.co/api/v1.0/gateway/partners/{partner_code}/pre_card_orders/{order_id}

UnionPay Payment orders are applicable to PC web page and mobile H5 transactions. After creating the order, jump to the returned pay_url (additional signature parameters and redirect parameters are required). Then enter the web payment page to complete the payment.
This gateway currently only supports UnionPay International online credit card and debit card payments.

FieldDescription
Accept

application/json

Content-Type

application/json

Path Variable

FieldTypeDescription
partner_codeString

Required, Partner code

order_idString

Required, Partner order id

JSON keys

FieldTypeDescription
descriptionString

Required, order subject (maximum length is 128 characters, if it exceeds amount it will be cut)

priceint

Required, Price of the order. Use the base unit of the currency.

currencyString

Currency

Default value: GBP

Allowed values: GBP

notify_urlString

System will call the notify url if provided when the payment succeeds

operatorString

Note for the operator who created this order.

Query Params

FieldTypeDescription
timeLong

Required, UTC timestamp in milliseconds

nonce_strString

Required, Random string

signString

Required, Sign

Success 200

FieldTypeDescription
return_codeString

Execution result

result_codeString

SUCCESS Indicates that the order was created successfully,EXISTS Indicates that the order already exists

channelString

Channel.Yeepay.

partner_codeString

Partner code

full_nameString

Partner's full company name when registered

partner_nameString

Partner's name

order_idString

Order id in GlobePay

partner_order_idString

Partner order id

pay_urlString

Card payment page

Error Code

NameDescription
ORDER_NOT_EXIST

Order does not exist

ORDER_MISMATCH

Order is not belong to this partner

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

ERROR

NameDescription
return_code

Error Code

return_msg

Error Description

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