Skip to main content
POST
Paystack transfer & payment events webhook

Description

Authentication: Verified via x-paystack-signature header containing HMAC-SHA512 of the request body signed with the workspace’s BYO Paystack secret key. Supported events:
  • transfer.success: Marks payment as completed and records completion timestamp
  • transfer.failed: Marks payment as failed and reopens the linked payment request to pending
  • transfer.reversed: Marks payment as reversed and reopens the linked payment request to pending

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Headers

x-paystack-signature
string
required

HMAC SHA512 signature of request body

Body

application/json
event
enum<string>
required
Available options:
transfer.success,
transfer.failed,
transfer.reversed
Example:

"transfer.success"

data
object
required

Response

Webhook processed successfully

status
string
Example:

"success"

event
string
Example:

"transfer.success"