Direct Deposit to Permanent Address Webhook Notification

CCPayment will post the Webhook notification when the permanent address has received the payment.

Webhook notification

There are three transaction statuses in the webhook notification under the field name “pay_status”. CCPayment will credit assets if the pay_status is “success”, which is the one and only status you should consider as the confirmation of the transaction. The other two pay_status, “pending” and “processing”, can not be regarded as the confirmation of the transaction.

Header

Name	Value	Required	Type	Description
Content-Type		Y	string	application/json; charset=utf-8
Appid	202302010636261620672405236006912	Y	string	Merchant's unique credential. Find it on the Developer page.
Timestamp	1677152490	Y	string	Timestamp in seconds (10-digit). The request is valid for two minutes.
Sign	871f0223c66ea72435208d03603a0cb00b90f6ac4a4ba725d00164d967e291f6	Y	string	SHA-256 (appId + appSecret + timestamp+body (json string))

Body

```json
{
	"pay_status": "success",
	"order_type": "Direct Deposit",
	"record_id": "202307191012191681607895159656448",
	"paid_amount": "666",
	"credit_amount": "665.8002",
	"chain": "BSC",
	"from_address": "0x3E89fcC505xxxxxx6AA4b78fecB3b2d2D8",
	"to_address": "0x3E89fcC5050bCEc6xxxxxx096F386AA4b78f",
	"contract": "0x55d398326f99059ff775485246999027b3197955",
	"crypto": "USDT",
	"txid": "internal transfer",
	"service_fee": "0.1998",
	"memo": "",
	"user_id": "10192128173"
}
```

Parameters

Name	Type	Description
pay_status	string	Payment status: pending, processing, success, failed pending: The transaction started, it is waiting to be sent out to the blockchain. processing: It’s being processed on the blockchain.
order_type	string	Direct Deposit
record_id	string	Trading record: one transaction generates one unique record_id
paid_amount	string	Received amount
service_fee	string	Service fee charged by CCPayment
credit_amount	string	Amount credited to merchant's account credit_amount=paid_amount-service_fee
chain	string	Chain for this transaction
contract	string	Contract
crypto	string	Crypto symbol
from_address	string	Sending address of the payment
to_address	string	Permanent deposit address for users
memo	string	Memo/tag; unique identification for address
txid	string	Txid
user_id	string	The unique user id of this address

Remarks

Return Appid, Sign, Timestamp in the header of the response. The signature method SHA-256 (appid+appSecret+Timestamp+body).

Please use the data with caution if the signature verification fails. It indicates that the data has been tampered with.

The direct deposit webhook notification was only posted the token configured by the merchant was deposited.

Once the merchant has processed the order, please return {http code: 200} and include a “success” string in the HTTP response body.

If CCPayment does not receive “success” as a response from the merchant, CCPayment will keep pushing the notification up to 6 times. Any response other than “success” will be regarded as a failure, and CCPayment will keep sending the notification.

Example

PHP

$this->response->setString("success")

Java

this.response.setString("success");

Golong

this.response.SetString("success")

Python

self.response.set_string("success")

Node.js

this.response.setString("success");

Response Example