API Documentation
NeoX documents
NeoX documents
  • Introduction
  • NeoX App
    • E-Wallet
    • eKYC
    • Functionality
  • Payment Gateway
    • Payment Methods
    • Integrations
      • Hosted Checkout
        • Plugin/Extenstion
        • iOS SDK
        • Android SDK
        • React Native SDK
        • Web SDK
        • APIs
      • Direct API
        • Tokenization
      • Refund
        • APIs
        • IPN
    • Transaction Management
      • Query DR
      • Cancel
      • IPN
      • Error Codes
      • Refund on portal
    • Reconciliation
    • Settlement
  • Disbursement
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • Generate token API
      • Get merchant profile API
      • Request disbursement API
      • Get disbursement transaction API
      • Get exchange rate API
      • Inquiry bank account API
      • Currency conversion API
      • Event Notification
      • Response Data Structure
      • Error codes
    • Disbursement Account
    • Disbursement request
    • Transaction Management
      • Query Request/Transaction
      • Webhook
      • Error Codes
    • Reconciliation
  • Collections
    • Integration
      • Introduction
      • How To Register
      • Security Method
      • API authenPlatform
      • API upload file
      • APIs for virtual accounts management
        • API create list of virtual accounts
        • API update KYC virtual account information
        • API update Virtual Account transaction data from merchant
        • API set active/inactive Virtual Account
        • API get list virtual accounts
        • API get detail virtual account
      • APIs for transactions management
        • API update transaction documents
        • API get list transactions
        • API get detail transaction
      • APIs for refund requests management
        • API create refund request
        • API get list refund requests
        • API get detail refund request
      • APIs for withdraw requests management
        • API get list withdraw banks
        • API create withdraw request
        • API get list withdraw requests
        • API get detail withdraw request
      • Event Notification
      • SFTP upload document file of collection transaction
      • Error Codes
    • Virtual Account Management
      • Virtual Account
      • Virtual Account Status
      • Webhook
    • Transaction Management
      • Webhook
    • Transaction Status Management
      • Webhook
    • Refund Request Management
      • Webhook
    • Withdraw Request Management
      • Webhook
    • Reconciliation
    • Settlement
  • Merchant Portal
    • Onboarding
    • Payment Gateway
      • Reconciliation
      • Withdraw
    • Disbursement
      • Reports
    • Collections
      • Reports
      • Withdraw
Powered by GitBook
On this page
  • Instant Payment Notification
  • How to verify the IPN
  • NeoX's IPN data
  • Merchant response

Was this helpful?

  1. Payment Gateway
  2. Transaction Management

IPN

PreviousCancelNextError Codes

Last updated 7 months ago

Was this helpful?

Instant Payment Notification

Merchant can get payment result via IPN (Instant Payment Notification).

Merchant needs to build a RESTful API to receive data from NeoX after the transaction is completed. This API must be registered to NeoX before the payment is made

Method: POST

Data refer to .

Merchant has to respond to NeoX following the structure when receiving IPN.

Process Flow

How to verify the IPN

How to validate neo_SecureHash

  • Format: hex string, 64 characters, uppercase

  • Using cryptographic hash function SHA256

How to build

  • Input is all parameters on PaymentURL or ReturnURL.

  • Only use parameters that start with prefix neo_.

  • String must be sorted in alphabetical order base on parameter name.

  • NeoX will provide a Secret Key to merchant to hash.

IPN verification

Merchant needs to build a hashed string follow above guide and compare to received neo_SecureHash parameter

NeoX's IPN data

Parameter
Data type
Description

neo_MerchantCode

String

The merchant code is provided by NeoX.

neo_Currency

String

neo_Locale

String

The language will use on payment page, support: “vi”, “en".

neo_Version

String

Payment gateway version, “1” as default

neo_Command

String

"PAY" as default.

neo_Amount

Number

Order amount.

neo_MerchantTxnID

String

Transaction ID is provided by merchant, it must be unique on merchant’s system and on each request, accept only characters, numerics and list of symbols: “-”, “_”.

neo_OrderID

String

Order ID of the transaction, only accept characters, numerics and list of symbols: “-”, “_”.

neo_OrderInfo

String

Order information, max length 256

neo_TransactionID

String

Unique - Transaction ID is generated by NeoX.

neo_PayToken

String

neo_ResponseCode

Number

neo_ResponseMsg

String

Error description.

neo_SecureHash

String

Use SHA256 to hash the above parameters (sort the key by Alphabet order) + Secret Key (is provided by NeoX after actual integrating).

Some fields in IPN data but not using to create neo_SecureHash

Parameter
Data type
Description

neo_TransAmount

number

Transaction amount (partial payment).

neo_ExtData

Object

Extra data of transaction.

Merchant response

Parameter
Data type
Description

respcode

Number

  • 0: Successful, merchant received IPN.

  • 1: Failed, NeoX will retry the IPN.

respmsg

String

Error message. Default is “received”

Refer to

Using for service

Result of transaction: 0: transaction success != 0: transaction failed, refer to

table of error code
Tokenization
NeoX's IPN data
merchant response
table of error code