Bridge

Create a paykey from a Quiltt token

Changed on

Creates a new paykey using a Quiltt token as the source. This endpoint allows you to create a secure payment token linked to a bank account authenticated through Quiltt.

post/v1/bridge/quiltt

Request

  • Base URL
    https://sandbox.straddle.com
  • URL
    https://sandbox.straddle.com/v1/bridge/quiltt
  • Auth
    HTTP bearer

Headers

Straddle-Account-Idstring uuid

For use by platforms to specify an account id and set scope of a request.

Request-Idstring

Optional client generated identifier to trace and debug a request.

Correlation-Idstring

Optional client generated identifier to trace and debug a series of requests.

Idempotency-Keystring

Optional client generated value to use for idempotent requests.

Request body

customer_idstring uuid required

Unique identifier of the related customer object.

quiltt_tokenstring required

Quiltt processor token generated by your application for use with the Straddle API.

metadataobject nullable

Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the paykey in a structured format.

external_idstring nullable

Unique identifier for the paykey in your database, used for cross-referencing between Straddle and your systems.

Response

Created

response_type'object' | 'array' | 'error' | 'none' required

Indicates the structure of the returned content.

  • "object" means the data field contains a single JSON object.
  • "array" means the data field contains an array of objects.
  • "error" means the data field contains an error object with details of the issue.
  • "none" means no data is returned.

Example response

{
  "data": {
    "label": "Bank of America ****1234",
    "institution_name": "Bank of America",
    "status_details": {
      "message": "Bank account sucesfully validated"
    },
    "bank_data": {
      "routing_number": "021000021",
      "account_number": "****1234"
    }
  }
}

Changes

  • de39a60c562eRevision changes
    • warning

      added the new mastercard enum value to the / response property for the response status (media type: text/plain)

    • warning

      added the new mastercard enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new mastercard enum value to the / response property for the response status (media type: text/json)

  • 456c9ef0c3a6Revision changes
    • warning

      added the new auto_hold enum value to the // response property for the response status (media type: text/plain)

    • warning

      added the new auto_hold enum value to the // response property for the response status (media type: application/json)

    • warning

      added the new auto_hold enum value to the // response property for the response status (media type: text/json)

    • warning

      added the new validating enum value to the // response property for the response status (media type: text/plain)

    • warning

      added the new validating enum value to the // response property for the response status (media type: application/json)

    • warning

      added the new validating enum value to the // response property for the response status (media type: text/json)