Track a server-to-server postback conversion
Records a cookieless conversion from a merchant server. Use `affiliateCode` for explicit server-side code attribution when no click is available. Use `sessionId` or `rcsid` from the redirect/SDK flow when available. Use `clickId` or `cid` only when the integration has the real click id; otherwise pass a `customerEmailHash` or `customerEmail` for email-hash fallback matching.
Records a cookieless conversion from a merchant server. Use affiliateCode for explicit server-side code attribution when no click is available. Use sessionId or rcsid from the redirect/SDK flow when available. Use clickId or cid only when the integration has the real click id; otherwise pass a customerEmailHash or customerEmail for email-hash fallback matching.
Authorization
bearerAuth API key issued from the merchant dashboard (prefix rc_live_ / rc_test_). Sent as Authorization: Bearer <token>. Used by the SDK and any direct server-to-server integration.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://app.refcampaign.com/api/v1/conversions/postback" \ -H "Content-Type: application/json" \ -d '{ "amount": 1, "currency": "str", "externalId": "string", "conversionType": "SALE" }'{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "string",
"details": null
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z",
"requestId": "string"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "string",
"details": null
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z",
"requestId": "string"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "string",
"details": null
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z",
"requestId": "string"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "string",
"details": null
},
"meta": {
"timestamp": "2019-08-24T14:15:22Z",
"requestId": "string"
}
}Référence API
Parcourez chaque endpoint public avec des exemples de requête/réponse en direct et un playground try-it-out.
Refund a conversion and claw back its commission POST
Signals that a previously reported conversion was refunded or charged back. Intended for merchants billing outside Stripe Connect (e.g. Shopify Payments), where RefCampaign receives no refund webhook. The conversion is identified by its `externalId`. Omit `amount` for a full refund, or pass the refunded amount in minor units (cents, in the conversion currency) for a partial refund. Pass `refundExternalId` for each merchant refund event so successive partial refunds accumulate while retries of the same refund remain no-ops. Pending commissions are rejected; already-paid commissions get a prorated negative clawback entry. Legacy calls without `refundExternalId` remain idempotent: a second call on an already-refunded conversion is a no-op.