PayByMail

È un tipo di pagamento in cui l'esercente può incassare online senza avere bisogno di un sito web ma semplicemente utilizzando un link di pagamento.

Questa funzionalità può essere utilizzata in questi modi:

• Innesco tramite API
• Utilizzando il Back Office

---

---

POST 01_Init

{{endpoint}}/pgw/paybymail/init

Per innescare un pagamento in modalità PayByMail:

1. Invocare il servizio INIT del PAYBYMAIL
2. Comunicare al cliente l'url ricevuto in risposta per proseguire con il pagamento. La comunicazione del link può avvenire tramite diretto (linkType = LINK) o tramite email (linkType = MAIL)

REQUEST

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "550e8400-e29b-41d4-a716-446655440000"
  },
  "txReq": {
    "txOp": "RESERVATION",
    "amount": {
      "value": 100,
      "currency": "EUR"
    }
  },
  "poiInfo": {
    "pitype": "CC"
  },
  "buyer": {
    "email": "john.doe@email.com",
    "language": "IT"
  },
  "callbackURL": "https://www.merchant.com/callback",
  "linkType": "LINK"
}

RESPONSE

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "550e8400-e29b-41d4-a716-446655440000",
    "resultCode": "IGFS_000",
    "errDescription": "string"
  },
  "mailId": "string",
  "linkURL": "https://api.netsgroup.com/payment",
  "linkExpDt": "2023-03-27T02:01:00"
}

---

GET 02_Verify

{{endpoint}}/pgw/paybymail/verify

Il servizio VERIFY del PayByMail restituisce lo stato del PayByMail.

Query Parameters

Nome	Valore	Descrizione
mailId	string	-
merId	{{merId}}	-
txId	550e8400-e29b-41d4-a716-446655440000	-

REQUEST

{{endpoint}}/pgw/paybymail/verify?mailId=string&merId={{merId}}&txId=550e8400-e29b-41d4-a716-446655440000

RESPONSE

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "550e8400-e29b-41d4-a716-446655440000",
    "resultCode": "IGFS_000",
    "errDescription": "string"
  },
  "txRes": {
    "paymentId": "00123858103104830100",
    "tranId": 3061705740916817,
    "status": "OK"
  },
  "mailId": "string",
  "linkExpDt": "2023-03-27T02:01:00"
}

---

DELETE 03_Delete

{{endpoint}}/pgw/paybymail/delete

Il servizio DELETE del PayByMail elimina la transazione paybymail indicata.

Query Parameters

Nome	Valore	Descrizione
mailId	string	-
merId	{{merId}}	-
txId	550e8400-e29b-41d4-a716-446655440000	-

REQUEST

{{endpoint}}/pgw/paybymail/delete?mailId=string&merId={{merId}}&txId=550e8400-e29b-41d4-a716-446655440000

RESPONSE

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "550e8400-e29b-41d4-a716-446655440000",
    "resultCode": "IGFS_000",
    "errDescription": "string"
  },
  "mailId": "string"
}