@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Adyen BinLookup API
@base https://pal-test.adyen.com/pal/servlet/BinLookup/v54
@version 54
@auth ApiKey X-API-Key in header | Bearer basic
@endpoints 2
@toc get3dsAvailability(1), getCostEstimate(1)

@group get3dsAvailability
@endpoint POST /get3dsAvailability
@required {merchantAccount: str}
@optional {additionalData: map, brands: [str], cardNumber: str, recurringDetailReference: str, shopperReference: str}
@returns(200) {binDetails: map{issuerCountry: str}, dsPublicKeys: [map], threeDS1Supported: bool, threeDS2CardRangeDetails: [map], threeDS2supported: bool}
@errors {400, 401, 403, 422, 500}

@endgroup

@group getCostEstimate
@endpoint POST /getCostEstimate
@required {amount: map{currency!: str, value!: int(int64)}, merchantAccount: str}
@optional {assumptions: map{assume3DSecureAuthenticated: bool, assumeLevel3Data: bool, installments: int(int32)}, cardNumber: str, encryptedCardNumber: str, merchantDetails: map{countryCode: str, enrolledIn3DSecure: bool, mcc: str}, recurring: map{contract: str, recurringDetailName: str, recurringExpiry: str(date-time), recurringFrequency: str, tokenService: str}, selectedRecurringDetailReference: str, shopperInteraction: str(Ecommerce/ContAuth/Moto/POS), shopperReference: str}
@returns(200) {cardBin: map{bin: str, commercial: bool, fundingSource: str, fundsAvailability: str, issuerBin: str, issuingBank: str, issuingCountry: str, issuingCurrency: str, paymentMethod: str, payoutEligible: str, summary: str}, costEstimateAmount: map{currency: str, value: int(int64)}, costEstimateReference: str, resultCode: str}
@errors {400, 401, 403, 422, 500}

@endgroup

@end