Verify Trusted Card

Verify a trusted card by confirming the USD micro-charge amount that was applied during card creation. This step is required before the card can be used for charges.

Endpoint

POST /trusted-cards/{uuid}/verify

Access	Requirement
Authenticated	Yes
Required Scope	`wapi-trusted-cards-verify`, or `wapi-trusted-cards-all`
Rate Limit	15 requests per minute

Request

Headers

Header	Value
`Accept`	`application/json`
`Authorization`	`Bearer <access_token>`
`X-WAPI-Key`	`wapi_live_<kid>_<secret>` or `wapi_test_<kid>_<secret>`

Send exactly one of Authorization or X-WAPI-Key.

Path Parameters

Parameter	Type	Required	Description
`uuid`	string	Yes	The UUID of the trusted card to verify

Body (form-data)

Parameter	Type	Required	Description
`amount`	number	Yes	The positive micro-charge amount used to verify the card

You can obtain the uuid from the successful redirect to your response_url during card creation, or later through Retrieve Trusted Cards.

Notes:

uuid must be a valid UUID.
amount must be greater than zero.
The backend accepts either the original USD micro-charge amount or the amount converted into the platform's primary processing currency.

Responses

200 OK

{
  "message": "OK"
}

400 Bad Request

Missing UUID

{
  "message": "The uuid is not a valid UUID (version 4)."
}

Verification amount is incorrect

{
  "message": "The amount is incorrect."
}

401 Unauthorized

{
  "message": "Unauthorized"
}

403 Forbidden

Already verified

{
  "message": "Your card has already been verified."
}

Verification window expired

{
  "message": "The verification window has expired."
}

Invalid scopes

{
  "message": "Invalid scope(s) provided."
}

Example

curl -X POST "https://ttsb.wipayfinancial.com/wapi/trusted-cards/213e4777-2179-4fbd-9540-84e8ed83187a/verify" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "amount=0.80"

On this page