# Sale #### **Utilizing the `doSale` Method in the Merchant PayContactless SDK** **Overview**: The `doSale` method of the Merchant PayContactless SDK is a pivotal function for executing transactions within merchant applications. Primarily, it is designed to process and receive payments. **Parameters**: 1. **Amount**: * **Description**: Denotes the transaction's value as specified by the user. * **Constraints**: * Should be a whole number, with its length capped at 12 digits. * Exclude any separators or currency symbols. * **Examples**: * A payment amount of $100 should be conveyed as 10000, where the trailing two digits represent cents. * Conversely, $1.01 is represented as 101. 2. **Description**: * **Description**: Provides contextual information detailing the purpose or reason behind the payment. It could relate to the product/service name, a brief summary, or any relevant description the merchant deems necessary. 3. **Currency Code** * **Description**: The currecy value of the transaction. It has be numeric code of ISO 4217 format. * **Examples:** * 566 for Naira instead of NGN 4. **Activity** * **Description**: The current activity. Payment page is started as a new activity. In order to start payment activity Embed SDK needs the current acitivity of the app. 5. **RFU Map** * **Description:** RFUMap (Reserved for future use) object is used to transfer key value pairs between backend system and merchant application 6. **TransactionResultListener**: * **Description**: This interface is vital as it captures and manages transaction outcomes, be it success or failure scenarios. **Usage**: To implement the `doSale` function in your application, ensure you're capturing the correct parameters, especially the format for the "Amount" and supplementing the necessary information in the "Description." By adhering to these guidelines, you enable a precise and seamless transaction process, elevating the user experience within your application. ```java PayContactlessEmbed.getInstance().doSale( amount: String, description: String?, currencyCode: String?, activity: FragmentActivity, rfuMap: Map?, listener: TransactionResultListener ) ``` | Field Name | Data Type | Required | Description | | ------------ | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | amount | String | true | Transaction amount to be charged. The value should be formatted according to the SDK’s amount specification (e.g., minor units or decimal format as configured, 200000). | | description | String | false | Optional description or narration for the transaction, used for reference and reporting purposes. | | currencyCode | String | false | ISO 4217 currency code for the transaction (e.g., `NGN`, `USD`). If null, the default terminal currency is used. | | activity | FragmentActivity | true | Host activity used to launch and display the SDK transaction UI. Must be a valid and active `FragmentActivity`. | | rfuMap | Map\ | false | Reserved for future use (RFU). Allows passing additional key–value parameters for extended or custom transaction data. | | listener | TransactionResultListener | true | Callback interface used to receive transaction success, failure, or status updates. | {% hint style="info" %} If currency parameter is set null, the default currency is used for transaction. The default currency is Naira in SDK. {% endhint %} When a transaction is completed, the TransactionResult class is received on onCompleted method, these class fields can be used for the payment result screens. ## **Transaction Listener** ```java public interface TransactionResultListener { void onCompleted(TransactionResult transaction); } ``` ## **Transaction Result** ```kotlin data class TransactionResult( var paymentType: String?, var status: String, var payWithCardResult: Transaction? = null, var payWithAccountResult: FinishTrx?=null; var payWithLinkResult: PayWithLinkResult? = null var error : ErrorData? = null ) ```
Field NamesField DescriptionsValues
Payment Typereturn the data in which method in use for this transaction

object PaymentType {

const val CARD = "Card"

const val PAY_WITH_CARD = "PayWithCard"

const val ACCOUNT = "PayWithAccount"
const val PAY_WITH_LINK = "PayWithLink"

const val QR = "QR"

const val USSD = "USSD"

}

Statusresult of the transaction request

object TransactionResult {

const val SUCCESS = "Success"

const val FAIL = "Fail"

const val CANCEL = "Cancel"

const val TIMEOUT = "Timeout"

}

PayWithCardResultReturns only after completing tap with card payment
PayWithAccountResultReturns only after completing BLE payment
PayWithLinkResultReturns only after completing link payment
ErrorCheck 6.1 Error Handling section
## **Transaction Data** ```kotlin data class Transaction ( var type: String? = null var amount: String? = null var code: String? = null var date: String? = null var time: String? = null var respCode: String? = null var respDesc: String? = null var rrn: String? = null var authCode: String? = null var stan: String? = null var cardNumber: String? = null var cardType: String? = null var cardBrand: String? = null var aid: String? = null var isPinUsed = false var rfuList: Map? = null ) ```
Field NamesDescriptionsSample Values
typetype of the transaction'PAYMENT'
amountusing amount value in the transaction'150000'
codea unique code of the transaction. It is used for finding the transaction.'1D9F9EE737CE1262'
datetransaction date “yyyymmdd”'20220823'
timetransaction time “hhmmss”'080905'
respCodeResponse Code of the transaction'00'
respDescResponse Description of the transaction'Success'
rrnReference Retrieval Number of the transaction'202208230809'
authCodeAuthorization Code of transaction'080905'
stanSystem Trace Audit Number of the transaction'15590'
cardNumbermasked pan of the card using in the transaction'************6375'
cardTypetype of the card using in the transaction'CREDIT'
cardBrandbrand of the card using in the transaction'VISA'
aidApplication Identifier of the card using in the transaction'a0000000031010'
isPinUsedis pin used in this transaction or notfalse
rfuListRFUList (Reserved for future use) object is used to transfer key value pairs between backend system and merchant application