Payouts for UzCard/HUMO

URL payment gateway

https://paysys.uz/gateway

Payouts preparation

Method's name: cash2card.prepare_remittance
Authorization: requires

Request contains:

• partner_transaction_id - Payment ID in partner's system
• card_number - Card number of receiver
• amount - Payout amount in tiins - minimum 100 000 tiin
• sender -Sender's data
  • last_name - Sender's surname
  • first_name - Sender's name
  • middle_name - Sender's middle name (if exists)
• doc - Passport data. Mandatory data block for payouts with a limit from 50 BCV ~ equals to 1300$` and above, otherwise you cannot send the parameter
  • nationality - Citizenship, numeric country code ISO 3166-1
  • type - Document's type
    passport - Passport
  • seriesNumber - Series and document number
  • birthDate - Birth date
  • validTo - Document validity period
  • mrz - PINFL (if exists)

Request example

{
  "method": "cash2card.prepare_remittance",
  "params": {
    "partner_transaction_id": 10181,
    "card_number": "8600530410609500",
    "amount": 400000,
    "sender": {
      "last_name": "Test",
      "first_name": "Test",
      "middle_name": ""
    }
  },
  "id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800"
}

Request example from 50 БРВ

{
  "method": "cash2card.prepare_remittance",
  "params": {
    "partner_transaction_id": 10182,
    "card_number": "8600530410609500",
    "amount": 1445000000,
    "sender": {
      "last_name": "Test",
      "first_name": "Test",
      "middle_name": ""
    },
    "doc": {
      "nationality": "860",
      "type": "passport",
      "seriesNumber": "AA0000001",
      "birthDate": "25.01.1990",
      "validTo": "25.01.2025",
      "mrz": "30101800050014"
    }
  },
  "id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800"
}

Response contains:

• transaction_id - Transaction ID in the PaySys
• partner_transaction_id - Payment ID in partner's system
• masked_phone_number - Sender's phone number linked to the card
• recipient_card - Card number of receiver
• recipient_name - Receiver's name
• amount - Payout amount in tiinakh
• commission - Payout fee in percent
• total - Debit amount from the sender's deposit in tiins

Response example

{
  "id": "fcc851bd-1ed4-4586-8a8b-34044e5d8800",
  "error": null,
  "result": {
    "transaction_id": 2354812,
    "partner_transaction_id": 10181,
    "masked_phone_number": "+99890*****50",
    "recipient_card": "860031******2112",
    "recipient_name": "TEST2 TEST2",
    "amount": 400000,
    "commission": 0.5,
    "total": 402000
  }
}

In case of incorrect request parameters, system will return an error.

---

Payout confirmation

Method's name: cash2card.confirm_remittance
Authorization: requires

Request contains:

• transaction_id - Payment ID in the PaySys

Request example

{
  "method": "cash2card.confirm_remittance",
  "params": {
    "transaction_id": 2354812
  },
  "id": "0aea069d-66da-4af9-af53-c4157c354e2c"
}

Response contains:

• transaction_id - Payment ID in the PaySys
• status - Payout status in the PaySys
  2 - Payout is canceled
  1 - Payout is completed
  3 - Payout is reversed
  0 - Payout is created
  -1 - Error
• date - Creation date of payout in seconds

Response example

{
  "id": "0aea069d-66da-4af9-af53-c4157c354e2c",
  "error": null,
  "result": {
    "transaction_id": 2354812,
    "status": 1,
    "date": 1648988775
  }
}

In case of incorrect request parameters, system will return an error.

---

Verification status of payout

Method's name: cash2card.check_remittance
Authorization: requires

Request contains:

• partner_transaction_id - Payment ID in partner's system

Request example

{
  "method": "cash2card.check_remittance",
  "params": {
    "partner_transaction_id": 10181
  },
  "id": "82a6dfe8-a8ed-40c7-8758-7c2d8f7b9073"
}

Response contains:

• transaction_id - Payment ID in the PaySys
• status - Payout status in the PaySys
  2 - Payout is canceled
  1 - Payout is completed
  0 - Payout is created
  -1 - Error
• card_number - Card number of receiver
• amount - Payout amount in tiins

Response example

{
  "id": "82a6dfe8-a8ed-40c7-8758-7c2d8f7b9073",
  "error": null,
  "result": {
    "status": 1,
    "transaction_id": 2354812,
    "card_number": "860031******2112",
    "amount": 400000
  }
}

In case of incorrect request parameters, system will return an error.

---

Payout cancellation

Method's name: cash2card.cancel
Authorization: requires

Request contains:

• transaction_id - Payment ID in the PaySys

Request example

{
  "method": "cash2card.cancel",
  "params": {
    "transaction_id": 2354812
  },
  "id": "92251a16-661c-4482-ac60-5222e4a27cb7"
}

Response contains:

• result - Effective cancellation

Response example

{
  "id": "92251a16-661c-4482-ac60-5222e4a27cb7",
  "error": null,
  "result": true
}

In case of incorrect request parameters, system will return an error.

---

Reconciliation of payments

Method's name: cash2card.statement
Authorization: requires

Reconciliation is necessary to identify problems in making payments. It is recommended to carry out the reconciliation procedure daily outside of working hours.

Request contains:

• date_from -Start date of the reconciliation interval in seconds
• date_to - End date of the reconciliation interval in seconds

Request example

{
  "method": "cash2card.statement",
  "params": {
    "date_from": 1648926000,
    "date_to": 1649012399
  },
  "id": "109ab538-b430-4e72-a75c-410cc482da4f"
}

The response contains a list of payout details, where:

• status - Payout status in the PaySys
  2 - Payout is canceled
  1 - Payout in pending status
  0 - Payout is created
  -1 - Error
• transaction_id - Transaction ID in the PaySys
• partner_transaction_id - Payment ID in partner's system
• recipient_card_number - Card number of receiver
• recipient_name - Receiver's name
• amount - Payout amount in tiins
• commission_amount: - Commission amount for payments in tiins
• date -Creation date of payout in seconds

Response example

{
  "id": "109ab538-b430-4e72-a75c-410cc482da4f",
  "error": null,
  "result": [
    {
      "status": 1,
      "transaction_id": 2354812,
      "partner_transaction_id": 10181,
      "recipient_card_number": "860031******2112",
      "amount": 400000,
      "commission_amount": 2000,
      "date": 1648988775
    }
  ]
}

In case of incorrect request parameters, system will return an error.