💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  • Bank Card Transaction Notification
  • Request URL
  • Request Method
  • Notification Parameters Description
  • Partner Response Parameters Description
  1. Physical card
  2. API Integration

Bank Card Transaction Notification

Bank Card Transaction Notification

Request URL

URL provided by the partner for notification.

Request Method

POST

Notification Parameters Description

Field Name
Variable Name
Required
Type
Base64 Encoding
Description

Card Token

cardId

No

String

No

Transaction Card Number

cardNo

Yes

String(32)

No

Abbreviated card number (showing first 6 and last 4 digits)

Transaction Currency

currency

Yes

String(4)

No

Transaction currency, EUR/USDT

Transaction Amount

amount

Yes

Double

No

Transaction amount

Transaction Fee

fee

Yes

Double

No

Transaction fee

Actual Transaction Currency

currencyTxn

Yes

String(3)

No

Payment currency, returned when different from transaction currency

Actual Transaction Amount

txnAmount

Yes

Double

No

Payment amount, returned when different from transaction currency

Business Date

businessDate

Yes

Date

No

Business date

Transaction ID

tradeId

Yes

String(32)

No

Transaction ID

Authorization Code

authCode

No

String(6)

No

Authorization code

Transaction Type

tradeType

Yes

Integer

No

See 6-6

Transaction Source

tradeSrc

Yes

Char(1)

No

A: Authorization, S: Settlement

Transaction Status

tradeStatus

Yes

Integer

No

By default, only successful transactions are returned. Returns when version=2.0. See 6-7

Merchant Description

remark

Yes

String(200)

No

Merchant description of the transaction

Partner Response Parameters Description

Field Name
Variable Name
Required
Type
Base64 Encoding
Description

Return Code

returnCode

Yes

String

No

success

Return Message

returnMsg

No

String

No

If not empty, it contains the error reason.

Last updated 1 year ago