Start a phone (RP-initiated) signing order
Initiates a phone-channel signing order. Forwarded verbatim to BankID's `/phone/sign`. Poll `/collect` with the returned `orderRef`.
Authorization
ApiKeyAuth API key in the form cert_<prefix>_<secret>.
In: header
Query Parameters
Run the call as a background job and return 202 Accepted with a job_id.
Queue priority for async jobs.
Value in
- "low"
- "default"
- "high"
Header Parameters
Dedupe key so a retried async enqueue does not create a duplicate job.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Forwarded verbatim to BankID /phone/*. See BankID's API for all fields.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/service/bankid/phone/sign" \ -H "Content-Type: application/json" \ -d '{}'{ "orderRef": "string"}{ "job_id": "string", "status": "queued", "poll": "/service/jobs/<id>"}{ "error": "string", "detail": "string"}{ "error": "string", "detail": "string"}{ "error": "insufficient_credits", "message": "Organisationen har slut på krediter. Fyll på för att fortsätta."}{ "error": "string", "detail": "string"}{ "error": "string", "detail": "string"}{ "error": "upstream_unavailable", "service": "bankid", "message": "There is currently a problem with BankID. Please try again shortly."}{ "error": "string", "detail": "string"}Start a phone (RP-initiated) authentication POST
Initiates a phone-channel authentication. Forwarded verbatim to BankID's `/phone/auth`. No QR/autostart; poll `/collect` with the returned `orderRef`.
Start a BankID payment order POST
Starts a payment-confirmation order. Forwarded verbatim to BankID's `/payment`. **Always synchronous** (`?async` is ignored). Show the animated QR with `GET /service/bankid/qr-code?orderRef=…`.