/api/v1/card/pre-bind

post

https://openapitest.osl-pay.com/api/v1/card/pre-bind

This API allows merchants with PCI compliance to initiate a user bank card pre-binding request. Merchants must collect and submit the user's bank card information for quick payment binding in subsequent card-to-crypto transactions. Upon successful pre-bind, the API returns a unique OSL Pay card binding ID for use in future transactions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

userId

number

OSL Pay user ID
At least one of userId or merchantUserId must be provided

merchantUserId

string

Merchant-side user ID
At least one of userId or merchantUserId must be provided

string

IP address. Must comply with IPv4 or IPv6 standards.

cardNumber

string

required

Bank card number

expiryMonth

string

required

Card expiry month

expiryYear

string

required

Card expiry year – Use the last two digits of the year. For example, for 2026, pass 26.

cvv

string

required

Card CVV

country

string

required

Card issuing country, Use ISO 3166-1 standard (Must be 3 digits)

address

string

required

Billing address

city

string

required

Billing city

postalCode

string

required

Billing postal code

phone

string

Phone number

areaCode

string

International dialing code

firstName

string

required

Cardholder first name

lastName

string

required

Cardholder last name

billState

string

required

Billing state/region

clientInfo

object

Client information, passed as an object

clientInfoToken

string

Collect the token returned by clientInfo and replace the merchant's upload of clientInfo.

Headers

appId

string

required

timestamp

string

required

signature

string

required

Response

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success response