# Transmit (/global/en/docs/Terminal/DeviceServices/Transmit)

## Transmit

The Transmit service is responsible for forwarding the message information generated by the ECR (Electronic Cash Register) to the payment application.\
Through this service, the ECR can seamlessly transmit payment requests, transaction data, and other information to the payment system, ensuring a smooth and efficient payment process.\
The service ensures stable forwarding of the messages while supporting compatibility across different payment applications, ensuring data accuracy and consistency during the transaction process.

#### Transmit Request

**TransmissionParam**

**destinationAddress** *string* — Required

Transport address.

**maximumTransmissionTime** *integer* — Required

Maximum time in seconds of transmission.

**messageToSend** *bytes* — Required

Message to send.

**maximumWaitingTime** *integer*

Defines the timeout to receive an answer.

#### Transmit Response

**TransmissionResult**

**recipientPartyIdentification** *string* — Required

Unique identification of the partner that is the recipient of the message exchange.\
For example, the POS SN

**response** *enum* — Required

Result of the requested transaction.

**Possible enum values**

- `SUCC` — "Success.\nProcessing OK. Information related to the result of the processing is contained in other parts of the response message."
- `FAIL` — "Failure.\nProcessing of the request fails for various reasons."
- `PART` — "Partial Approved.\nThe service was partially completed. Use the Message Status service to query the final transaction status."

**responseReason** *string*

Detail of the response.

**Possible enum values**

- `ABRT` — "Aborted.\nThe initiator of the request has sent an abort message request, which was accepted and processed."
- `BUSY` — "Busy.\nThe system is busy, try later."
- `CANC` — "Cancel.\nThe user has aborted the transaction on the PED keyboard, for instance during PIN entering."
- `DEVO` — "DeviceOut.\nDevice out of order."
- `WPIN` — "WrongPIN.\nThe user has entered the PIN on the PED keyboard and the verification fails."
- `NHOS` — "UnreachableHost.\nAcquirer or any host is unreachable or has not answered to an online request, so is considered as temporary unavailable.\nDepending on the Sale context, the request could be repeated(to be compared with \\"Refusal\\")"
- `UNVS` — "UnavailableService.\nThe service is not available (not implemented, not configured, protocol version too old…)."
- `UNVD` — "UnavailableDevice.\nThe hardware is not available (absent, not configured…)"
- `REFU` — "Refusal.\nThe transaction is refused by the host or by the local rules associated to the card or the POI."
- `TNFD` — "NotFound.\nThe transaction is not found (e.g. for a reversal or a repeat)."
- `WIPG` — "InProgress.\nThe transaction is still in progress and then the command cannot be processed."

**additionalResponseInformation** *string*

Additional information to be logged for further examination.

**Transaction parameters**

When you receive the terminal result through the SDK callback interface and **TransmissionResult.response = SUCC**, you can obtain additional received message.

**receivedMessage** *bytes*

Content of a message received from another party, system, or process.

```java
TransmissionParam param = TransmissionParam.newBuilder()
        .destinationAddress("192.168.1.2")
        .maximumWaitingTime(60L)
        .messageToSend(new byte[1])
        .build();
RetailerManager.provideDeviceService()
        .newTransmissionExchange(param)
        .startAsyncExchange(new Exchange.RetailerSDKCallback<TransmissionResult>() {
            @Override
            public void onError(int code, String msg) {
                Logger.e(TAG, "Transmission failed: " + code + ", " + msg);
            }
            
            @Override
            public void onResult(TransmissionResult result) {
                Logger.i(TAG, "Transmission result: " + GsonUtils.toJson(result));
            }
        });
```