Create Debit Card

Adds a debit card to the withdrawer's account which they can withdraw funds to. Will check the card to see if its eligible to receive funds.

Authentication

x-coinflow-auth-user-idstring

The external identifier of the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Authorizationstring

The API key of the merchant - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

x-coinflow-auth-walletstring

The web3 wallet of the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

x-coinflow-auth-blockchainstring

The blockchain associated with the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

x-coinflow-auth-session-keystring

The session key generated for the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Request

This endpoint expects an object.

expYearstringRequiredformat: "^\d+$"=2 characters

The Cards Expiration Year ex: 2026 => 26

expMonthstringRequiredformat: "^\d+$"=2 characters

The Cards Expiration Month ex: January => 01 December => 12

cardTokenstringRequired>=1 character

This is the card token received from the CoinflowCardOnlyInput

addressobjectOptional

If address is not available on the user's KYC,the endpoint will return a 412 error and the request must be retried with the user's address information.

merchantIdstringOptional

Response

Errors

412

Precondition Failed Error

The web3 wallet of the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

The blockchain associated with the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

The session key generated for the end user - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

This endpoint expects an object.

The Cards Expiration Year ex: 2026 => 26

The Cards Expiration Month ex: January => 01 December => 12

This is the card token received from the CoinflowCardOnlyInput

If address is not available on the user's KYC,the endpoint will return a 412 error and the request must be retried with the user's address information.

$	curl -X POST https://api-sandbox.coinflow.cash/api/withdraw/debit-card \
>	-H "x-coinflow-auth-user-id: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"expYear": "26",
>	"expMonth": "12",
>	"cardToken": "tok_visa_1234567890abcdef"
>	}'

$	curl -X POST https://api-sandbox.coinflow.cash/api/withdraw/debit-card \
>	-H "x-coinflow-auth-user-id: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"expYear": "26",
>	"expMonth": "12",
>	"cardToken": "tok_visa_1234567890abcdef"
>	}'