Skip to main content
Cresora Commerce

Certification

Request and track partner certification checks. Certification is the gate a partner clears before onboarding real merchants.

ℹServer-to-server API
Run the examples on this page from your backend against the sandbox host. The API sends no CORS headers, so browser JavaScript cannot read its responses, and an API key must never be exposed in a browser. There is no interactive console here. Generating a client instead? Download the OpenAPI spec (YAML).

Get the caller's current re-certification request

GET/partner/me/certification/recertification-requests/current

Authorization

BearerAuth
AuthorizationBearer <token>

Cresora API key, sent as an opaque bearer token in the Authorization header. Format:

csk_<prefix>_<random>
  • <prefix> — 8 URL-safe chars, shown in UI and logs for identification without revealing the full key (e.g. csk_Ab3kX9mQ…). Use ApiKey.prefix to match.
  • <random> — 24+ cryptographically random URL-safe chars.

Obtain via Partner Portal → Settings → API keys. Keys are only shown in full at creation/rotation time — Cresora does not retain the full value in retrievable form. Rotate any key that may have been exposed via logs, client code, or source control.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/partner/me/certification/recertification-requests/current"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",  "requested_features": [    "TERMINAL"  ],  "message": "string",  "state": "PENDING",  "dismissed_reason": "string",  "created_at": "2019-08-24T14:15:22Z"}

Get the active certification flow

GET/certification/flows/active

Authorization

BearerAuth
AuthorizationBearer <token>

Cresora API key, sent as an opaque bearer token in the Authorization header. Format:

csk_<prefix>_<random>
  • <prefix> — 8 URL-safe chars, shown in UI and logs for identification without revealing the full key (e.g. csk_Ab3kX9mQ…). Use ApiKey.prefix to match.
  • <random> — 24+ cryptographically random URL-safe chars.

Obtain via Partner Portal → Settings → API keys. Keys are only shown in full at creation/rotation time — Cresora does not retain the full value in retrievable form. Rotate any key that may have been exposed via logs, client code, or source control.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/certification/flows/active"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",  "status": "ACTIVE",  "features": [    "TERMINAL"  ],  "created_at": "2019-08-24T14:15:22Z",  "completed_at": "2019-08-24T14:15:22Z",  "run_started_at": "2019-08-24T14:15:22Z",  "flow_type": "INITIAL",  "recertification_reason": "string",  "attempt_number": 1,  "supersedes_flow_id": "dcfff01b-cccd-4474-a561-eed33701839b",  "baseline": {    "features": [      "string"    ],    "check_codes": [      "string"    ],    "steps": [      {        "step": 0,        "label": "string",        "total": 0      }    ]  },  "progress": {    "total": 0,    "passed": 0,    "failed": 0,    "waived": 0,    "skipped": 0,    "pending": 0,    "awaiting_admin_review": 0,    "percent": 0,    "steps": [      {        "step": 1,        "label": "string",        "total": 0,        "resolved": 0,        "failed": 0,        "awaiting_admin_review": 0,        "unlocked": true,        "complete": true      }    ]  },  "checks": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "category": "string",      "label": "string",      "tier": "AUTOMATED",      "state": "PENDING",      "check_code": "string",      "tier_level": 1,      "step": 1,      "flag_group": "string",      "flag_group_label": "string",      "description": "string",      "pass_criteria": "string",      "attestation_statement": "string",      "result_notes": "string",      "waiver_reason": "string",      "submitted_by": "string",      "submitted_at": "2019-08-24T14:15:22Z",      "submittable": true,      "checked_by": "string",      "checked_at": "2019-08-24T14:15:22Z",      "last_run_at": "2019-08-24T14:15:22Z",      "failure_reason": "string",      "execution_logs": "string",      "request_payload": "string",      "retry_history": [        {          "attempt": 1,          "trigger": "RUN_START",          "verdict": "SATISFIED",          "resulting_state": "PENDING",          "failure_reason": "string",          "execution_logs": "string",          "evaluated_at": "2019-08-24T14:15:22Z",          "duration_ms": 0        }      ]    }  ]}

Get the latest completed certification flow

GET/certification/flows/latest-completed

Authorization

BearerAuth
AuthorizationBearer <token>

Cresora API key, sent as an opaque bearer token in the Authorization header. Format:

csk_<prefix>_<random>
  • <prefix> — 8 URL-safe chars, shown in UI and logs for identification without revealing the full key (e.g. csk_Ab3kX9mQ…). Use ApiKey.prefix to match.
  • <random> — 24+ cryptographically random URL-safe chars.

Obtain via Partner Portal → Settings → API keys. Keys are only shown in full at creation/rotation time — Cresora does not retain the full value in retrievable form. Rotate any key that may have been exposed via logs, client code, or source control.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/certification/flows/latest-completed"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",  "status": "ACTIVE",  "features": [    "TERMINAL"  ],  "created_at": "2019-08-24T14:15:22Z",  "completed_at": "2019-08-24T14:15:22Z",  "run_started_at": "2019-08-24T14:15:22Z",  "flow_type": "INITIAL",  "recertification_reason": "string",  "attempt_number": 1,  "supersedes_flow_id": "dcfff01b-cccd-4474-a561-eed33701839b",  "baseline": {    "features": [      "string"    ],    "check_codes": [      "string"    ],    "steps": [      {        "step": 0,        "label": "string",        "total": 0      }    ]  },  "progress": {    "total": 0,    "passed": 0,    "failed": 0,    "waived": 0,    "skipped": 0,    "pending": 0,    "awaiting_admin_review": 0,    "percent": 0,    "steps": [      {        "step": 1,        "label": "string",        "total": 0,        "resolved": 0,        "failed": 0,        "awaiting_admin_review": 0,        "unlocked": true,        "complete": true      }    ]  },  "checks": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "category": "string",      "label": "string",      "tier": "AUTOMATED",      "state": "PENDING",      "check_code": "string",      "tier_level": 1,      "step": 1,      "flag_group": "string",      "flag_group_label": "string",      "description": "string",      "pass_criteria": "string",      "attestation_statement": "string",      "result_notes": "string",      "waiver_reason": "string",      "submitted_by": "string",      "submitted_at": "2019-08-24T14:15:22Z",      "submittable": true,      "checked_by": "string",      "checked_at": "2019-08-24T14:15:22Z",      "last_run_at": "2019-08-24T14:15:22Z",      "failure_reason": "string",      "execution_logs": "string",      "request_payload": "string",      "retry_history": [        {          "attempt": 1,          "trigger": "RUN_START",          "verdict": "SATISFIED",          "resulting_state": "PENDING",          "failure_reason": "string",          "execution_logs": "string",          "evaluated_at": "2019-08-24T14:15:22Z",          "duration_ms": 0        }      ]    }  ]}

Get certification flow

GET/certification/flows/{flowId}

Authorization

BearerAuth
AuthorizationBearer <token>

Cresora API key, sent as an opaque bearer token in the Authorization header. Format:

csk_<prefix>_<random>
  • <prefix> — 8 URL-safe chars, shown in UI and logs for identification without revealing the full key (e.g. csk_Ab3kX9mQ…). Use ApiKey.prefix to match.
  • <random> — 24+ cryptographically random URL-safe chars.

Obtain via Partner Portal → Settings → API keys. Keys are only shown in full at creation/rotation time — Cresora does not retain the full value in retrievable form. Rotate any key that may have been exposed via logs, client code, or source control.

In: header

Path Parameters

flowId*string
Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/certification/flows/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",  "status": "ACTIVE",  "features": [    "TERMINAL"  ],  "created_at": "2019-08-24T14:15:22Z",  "completed_at": "2019-08-24T14:15:22Z",  "run_started_at": "2019-08-24T14:15:22Z",  "flow_type": "INITIAL",  "recertification_reason": "string",  "attempt_number": 1,  "supersedes_flow_id": "dcfff01b-cccd-4474-a561-eed33701839b",  "baseline": {    "features": [      "string"    ],    "check_codes": [      "string"    ],    "steps": [      {        "step": 0,        "label": "string",        "total": 0      }    ]  },  "progress": {    "total": 0,    "passed": 0,    "failed": 0,    "waived": 0,    "skipped": 0,    "pending": 0,    "awaiting_admin_review": 0,    "percent": 0,    "steps": [      {        "step": 1,        "label": "string",        "total": 0,        "resolved": 0,        "failed": 0,        "awaiting_admin_review": 0,        "unlocked": true,        "complete": true      }    ]  },  "checks": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "category": "string",      "label": "string",      "tier": "AUTOMATED",      "state": "PENDING",      "check_code": "string",      "tier_level": 1,      "step": 1,      "flag_group": "string",      "flag_group_label": "string",      "description": "string",      "pass_criteria": "string",      "attestation_statement": "string",      "result_notes": "string",      "waiver_reason": "string",      "submitted_by": "string",      "submitted_at": "2019-08-24T14:15:22Z",      "submittable": true,      "checked_by": "string",      "checked_at": "2019-08-24T14:15:22Z",      "last_run_at": "2019-08-24T14:15:22Z",      "failure_reason": "string",      "execution_logs": "string",      "request_payload": "string",      "retry_history": [        {          "attempt": 1,          "trigger": "RUN_START",          "verdict": "SATISFIED",          "resulting_state": "PENDING",          "failure_reason": "string",          "execution_logs": "string",          "evaluated_at": "2019-08-24T14:15:22Z",          "duration_ms": 0        }      ]    }  ]}

Recurring

Manage recurring billing plans. First payment captures a gateway token via HPP; subsequent charges use the stored token. Retries are configurable per plan (soft decline + ACH R01).

Webhooks

Manage webhook subscriptions — event types, delivery URLs, HMAC secret rotation. See `webhooks:` section for event schemas.