Create quote

Create a time-bound quote for a transfer request.

Endpoint

POST /quote

Query Parameters

• version (string, required) - API contract version. Use exactly 2024-10-01.

Header Parameters

• PW-subscription-key (string, required)
• PW-origin-country (string, required)
• PW-request-date (string, required) - UTC request timestamp formatted as YYYY-MM-DD HH:mm:ss.
• PW-ip-address (string, required)
• User-Agent (string, required)

Header Constraints

Key	Description	Example	Data type	Requirement	Field Length
PW-subscription-key	Developer key available after portal registration. Production key is shared on request.	eed0d85c530c4b26a91d09b783d8fab3	string	mandatory	32
PW-origin-country	ISO Alpha-2 country code where the transaction is created.	TT	string	mandatory	2
PW-request-date	Current request timestamp. Format: YYYY-MM-DD HH:mm:ss (UTC).	2014-10-08 16:01:31	string	mandatory	19
PW-ip-address	Fixed institution IP used for PayWise network-level validation.	255.255.255.255	string	conditional	8-16
User-Agent	In programmable environments, this avoids running into Cloudflare issues.	Mozilla/5.0 (Windows NT 10.0; Win64; x64)	string	mandatory	255

Request Body

{
  "session_token": "SESSION_TOKEN_REDACTED",
  "institution_name": "ExampleInstitution",
  "request_amount": "150.00",
  "request_currency": "USD",
  "debit_party": {
    "mobile_number": "18680001234",
    "organization_id": "ExampleOrg",
    "account_number": "ACCT-XXXXXX",
    "account_type": "wallet",
    "currency": "USD",
    "country": "US",
    "metadata": "sender-profile-a"
  },
  "credit_party": {
    "mobile_number": "18680001234",
    "organization_id": "ExampleOrg",
    "account_number": "ACCT-XXXXXX",
    "account_type": "wallet",
    "currency": "TTD",
    "country": "TT",
    "metadata": "beneficiary-profile-b"
  }
}

Downloads

• Download Postman-ready request body

Responses

200 - Quote created successfully.

{
  "status": "success",
  "code": 200,
  "message": "Quote created successfully.",
  "expire_date": "2026-02-26T16:45:00.000Z",
  "quote_id": "quote_01JQW9X7C5M6P8R2S4T6U8V0WX",
  "rate": "7.1205",
  "quote_date": "2026-02-26T16:40:00.000Z",
  "amount_quoted": "1068.08"
}

400 - Error response.

{
  "status": "error",
  "code": 403,
  "message": "Error: Exceeds user limits."
}

Notes

This endpoint page is generated from openapi/pw-wrappers.2024-10-01.yaml.