RevKeenDocs

Look up a pending signed mandate request

Public lookup of a pending signed mandate request by its emailed token. Rate-limited; returns 404 for unknown, consumed, cancelled, or expired tokens.


Related endpoints

  • POST /dd/validate — Validate a UK bank account for Direct Debit
  • POST /dd/preview — Preview the Direct Debit collection date chain

Common errors

  • 404 resource_missing — the referenced resource does not exist or is not visible to your key.
  • 429 rate_limit_exceeded — back off using the Retry-After header.
GET
/dd/mandate-requests/{token}

Path Parameters

token*string

Signed mandate-request token from the emailed link

Response Body

application/json

curl "https://api.revkeen.com/v2/dd/mandate-requests/string" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "data": {
    "id": "string",
    "merchant_id": "string",
    "merchant_slug": "string",
    "customer_id": "string",
    "invoice_id": "string",
    "expires_at": "string",
    "status": "pending_signature",
    "merchant": {
      "id": "string",
      "slug": "string",
      "name": "string"
    },
    "customer": {
      "id": "string",
      "name": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "string",
      "phone": "string"
    },
    "invoice": {
      "id": "string",
      "invoice_number": "string",
      "total": "string",
      "amount_due": "string",
      "currency": "string"
    }
  }
}
Empty
Empty