Webhook: Push Transaction Result

Description

The third party provides the request address to push transaction results, requiring signature verification.

Webhook

1

You Create a URL

You need to create a URL on your own server that is capable of receiving incoming POST requests from Paywizard. This is your "webhook link."

2

Submit the URL to Paywizard

You must give this URL to Paywizard support channels.

3

Paywizard Binds the URL

Paywizard will then link (or "bind") this URL to your specific developer account.

4

Automatic Data Pushes

Once bound, every time a transaction happen for any merchant operating under your developer account, Paywizard's server will automatically send a POST request containing the transaction data to your URL.

5

You Process the Data

Your server will receive this data and can then use it to trigger actions in your system, such as updating an order's status, notifying a customer, or recording the transaction in your database.

HTTP Header

Name	Value
Content-Type	application/json
sign-version	version of sign
paywizard-sign	PayWizard Open Platform API Signature Guide V3

Transaction Result Parameters

Name	Description	Mandatory	Type	Example	Description
checkoutId	Transaction Number		String
transIndexCode	External Third-Party System Order Number		String
paywizardId	PayWizard Number		String
mid	Acquiring Merchant Number		String
transType	Transaction Type		String
amount	Transaction Amount		String
state	Transaction Status		Integer		Transaction status 1: Pending Transaction 2: Transaction Completed 3: Revoked 4: Refund 5: Order Closed 6: Partial Refund 7: Pre-Authorization Completed 8: Pre-Authorization Revoked 9: Partial Revocation
currencyCode	Currency Code		String	840
tranTime	Transaction Time		LocalDateTime		yyyy-MM-dd HH:mm:ss
cardNo	Masked Card Number		String
cardToken	Card Token		String
transResult	Terminal Transaction Result		Integer		Terminal transaction result 0: Success 1: Failure 2: In Progress
transId	Terminal Acquiring Channel Transaction Serial Number		String		Returned when terminal transaction result is successful
invoiceNum	Terminal Transaction Invoice Number		String		Returned when terminal transaction result is successful
traceNum	Terminal Transaction Number		String		Returned when terminal transaction result is successful
rrn	Terminal Transaction Reference Number		String		Returned when terminal transaction result is successful
respCode	Terminal Transaction Response Code		String		Returned when terminal transaction is completed
respDesc	Terminal Transaction Response Description		String		Returned when terminal transaction is completed
notifyUrl	Message Push Address		String
sign	Signature String		String