S
docs.syncra.money
API ReferenceMerchant APIApi referenceWebhooks

Re-queue one webhook delivery (Stripe-style manual retry)

Re-queues ONE of the caller's own webhook deliveries for immediate redelivery. Only terminal-failure callbacks qualify (status ERROR or RETRY); PENDING/SUCCESS reject with 400 FAILED_PRECONDITION. Rate limit: at most one manual retry per callback per 60 seconds (429 RESOURCE_EXHAUSTED otherwise). A foreign callback_id is 403, an unknown one is 404. The re-queued row returns with status PENDING, response fields cleared and retry_count PRESERVED (unlike the admin retry which resets attempts). Dual-homed: HMAC pair or cabinet JWT. Empty JSON object body.

POST/api/v1/p2p/merchant/callbacks/{callback_id}/retry

Re-queues ONE of the caller's own webhook deliveries for immediate redelivery. Only terminal-failure callbacks qualify (status ERROR or RETRY); PENDING/SUCCESS reject with 400 FAILED_PRECONDITION. Rate limit: at most one manual retry per callback per 60 seconds (429 RESOURCE_EXHAUSTED otherwise). A foreign callback_id is 403, an unknown one is 404. The re-queued row returns with status PENDING, response fields cleared and retry_count PRESERVED (unlike the admin retry which resets attempts). Dual-homed: HMAC pair or cabinet JWT. Empty JSON object body.

Authorization

MerchantToken MerchantSignature
X-Merchant-Token<token>

64-character hex public merchant token assigned during onboarding.

In: header

X-Signature<token>

Stripe-style HMAC-SHA256 signature. Format: t=<unix_seconds>,v1=<hex_hmac_sha256> where hex_hmac = HMAC-SHA256(webhook_secret, "<unix_seconds>.<raw_body>"). Replay window: 5 minutes (60s future drift tolerated).

In: header

Path Parameters

callback_id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/v1/p2p/merchant/callbacks/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry" \  -H "Content-Type: application/json" \  -d '{}'
{  "callback": {    "callback_id": "f4a074ff-b67f-4fe6-8a19-9acf4989a084",    "deal_id": "2fa5b64f-5b72-4263-958e-07b76f41abe3",    "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea",    "callback_url": "http://example.com",    "status": "PENDING",    "retry_count": 0,    "response_code": 0,    "response_body": "string",    "next_retry_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z"  }}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}
{  "type": "../dictionary",  "title": "string",  "status": 0,  "detail": "string",  "instance": "../dictionary",  "errors": [    {      "field": "amount",      "message": "must be greater than 0",      "code": "POSITIVE_REQUIRED"    }  ]}
Empty