PayIn Payment Status Webhook

post

https://{merchantDomain}/{webhookPath}

Accosis PG sends this POST request to the merchant's configured payInWebhookUrl whenever a payment transaction reaches a terminal state. The merchant must respond with HTTP 200 to acknowledge receipt.

Path Params

webhookPath

string

required

Defaults to webhook/payment-status

Merchant-configured webhook path

Body Params

responseData

object

required

status

string

enum

required

Terminal status of the payment transaction

Allowed:

responseMsg

string

required

Human-readable message describing the payment outcome

responseCode

number

required

Response code indicating the outcome. 200 = SUCCESS, 400 = FAILED, 408 = EXPIRED, 202 = PENDING/CREATED/CANCELLED, 201 = VOID

Headers

x-accosis-signature

string

required

HMAC-SHA256 hex digest of the raw JSON request body, computed using the merchant's secret key. Use this to verify the webhook was sent by Accosis PG.

x-accosis-timestamp

string

required

Unix timestamp (seconds) of when the webhook was dispatched. Use this along with the signature to prevent replay attacks. Reject webhooks older than 5 minutes (300 seconds).

x-accosis-event

string

enum

required

Event type indicating the payment outcome

Allowed:

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Webhook acknowledged successfully. Merchant must return HTTP 200 to confirm receipt.