Customers
Get Card Verification
Available on the production API; confirm sandbox availability separately. Check a customer belonging to the authenticated business. Poll at most once per minute. Does not create a card or debit a wallet. Submit a new card request only when can_create_card is true; approval does not automatically start issuance.
GET
Available on the production API. Confirm sandbox availability separately with Swerv.
DEFAULT USD card request.
The customer must belong to the business authenticated by your bearer token.
This request does not create a card or debit a wallet.
Poll at most once per minute. A check can reconcile a pending verification;
multiple callers share the same refresh limit. Do not treat an HTTP 200 response
alone as approval: inspect status and can_create_card.
NOT_SUBMITTED, PENDING, APPROVED, REJECTED, and
RECONCILIATION_REQUIRED. Submit a new card request only when can_create_card
is true; issuance does not start automatically after approval.
A typed verification error can return HTTP 503 with code, message, and an
optional field. Preserve the pending UI state when status cannot be retrieved;
use the error code to decide whether to retry later or contact support.
See the complete non-Nigerian KYC flow for
document requirements, correction rules, and safe issuance retries.
Verification webhooks
notify subscribed businesses of document-verification approvals and rejections.
This endpoint remains the source for current eligibility and a fallback for
missed deliveries. Start verification separately with
Submit Card Verification.Authorizations
Response
Current verification status, not necessarily approval.