Check Surcharge | Run Developers

Prior to completing a transaction, you can use this endpoint to check if a transaction will incur a surcharge.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

midstringRequired

Merchant Account ID

postalstringRequired

Cardholder's postal code

account_tokenstringRequired

Tokenized account number

amountstringOptional

Transaction amount

Successful response with surcharge information

tokenstring

Type of payment method

postalstring

Status of postal code restrictions

fee_amountstring

Surcharge fee amount

messageslist of strings

Any additional messages or warnings

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -X POST https://javelin.runpayments.io/api/v1/surcharge \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"mid": "1234567890",
>	"postal": "10001",
>	"account_token": "tok_123456789abcdef",
>	"amount": "100.00"
>	}'

$	curl -X POST https://javelin.runpayments.io/api/v1/surcharge \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"mid": "1234567890",
>	"postal": "10001",
>	"account_token": "tok_123456789abcdef",
>	"amount": "100.00"
>	}'