Get Available Methods
Methods That Require Public Key
These methods depend on the public API key being set in the MoneyHashSDK
using the setPublicKey
method.
To obtain your public API key, please refer to the MoneyHash Integration Documentation.
Get Account Methods
To access the available pay-in methods, saved cards, and customer balances, call the getMethods
method with the appropriate search criteria.
Parameters:
currency
:String
- requiredamount
:Double?
- optionalcustomerId
:String?
- optionalflowId
:String?
- optional
// Retrieve available methods
try {
val currency = "USD"
val amount: Double? = 100.0 // Optional
val customerId: String? = "customer_id" // Optional
val flowId: String? = "flow_id" // Optional
val methods = moneyHashSDK.getMethods(currency = currency, amount = amount, customerId = customerId, flowId = flowId)
println("Available Payment Methods: ${methods.paymentMethods}")
println("Available Express Methods: ${methods.expressMethods}")
println("Saved Cards: ${methods.savedCards}")
println("Customer Balances: ${methods.customerBalances}")
} catch (throwable: Throwable) {
// Handle error
println("Error retrieving methods: ${throwable.message}")
}
Get Methods For Intent
The getMethods
method allows you to access the available pay-in/pay-out methods, saved cards, and customer balances associated with a specific intent.
Usage Example:
// Retrieve available methods using intent
try {
// The intentId should be obtained from your backend after creating an intent
val intentId = "your_intent_id_here"
val intentType = IntentType.Payment // or IntentType.Payout
val methods = moneyHashSDK.getMethods(intentId = intentId, intentType = intentType)
println("Available Payment Methods: ${methods.paymentMethods}")
println("Available Express Methods: ${methods.expressMethods}")
println("Saved Cards: ${methods.savedCards}")
println("Customer Balances: ${methods.customerBalances}")
} catch (throwable: Throwable) {
// Handle error
println("Error retrieving methods: ${throwable.message}")
}
Get Intent Details
To access all intent details related to a specific intentId
, use the getIntentDetails
method.
// Retrieve intent details
try {
val intentId = "your_intent_id_here"
val intentType = IntentType.Payment // or IntentType.Payout
val intentDetails = moneyHashSDK.getIntentDetails(intentId = intentId, intentType = intentType)
println("Intent Details: $intentDetails")
} catch (throwable: Throwable) {
// Handle error
println("Error retrieving intent details: ${throwable.message}")
}
Proceed With Payment
To proceed with a selected payment method, use the proceedWithMethod
method. This method allows you to initiate a payment using the chosen method, such as a payment method ID, saved card ID, or customer balance ID.
// Proceed with a selected method
try {
val intentId = "your_intent_id_here"
val intentType = IntentType.Payment
val selectedMethodId = "selected_method_id_here"
val methodType = MethodType.PAYMENT_METHOD // e.g., MethodType.PAYMENT_METHOD, MethodType.SAVE_CARD, MethodType.CUSTOMER_BALANCE
// If using a saved card that requires CVV, provide it in methodMetaData
val methodMetaData: MethodMetaData? = if (methodType == MethodType.SAVE_CARD) {
MethodMetaData(cvv = "123") // CVV if required
} else {
null
}
val intentResult = moneyHashSDK.proceedWithMethod(
intentId = intentId,
intentType = intentType,
selectedMethodId = selectedMethodId,
methodType = methodType,
methodMetaData = methodMetaData
)
println("Proceeded with method: $intentResult")
} catch (throwable: Throwable) {
// Handle error
println("Error proceeding with payment: ${throwable.message}")
}
Updated 11 days ago