Deposits


Hosted Payment Page

To use the hosted you need to call the transactionDepositLink query. This will generate a link to redirect your users to.

Once the user has completed an action they will be redirected to the success or failure urls you provided when configuring your application.

query transactionDepositLink {
  transactionDepositLink(id: "dZchb2J69BxsK4ETzTCgy")
}

Response

{info} The url changes between Development/SIT and Production. This url should not be cached or altered.

{
    "data": {
        "transactionDepositLink": "https:\/\/app-developer.tradesafe.dev\/pay\/dZchb2J69BxsK4ETzTCgy"
    }
}

Payment Gateways

If you do not want to use the hosted page and would rather integrate some or all of the payment methods directly using the transactionDeposit query for EFT and mutation for the OZOW, ECEN and SNAP methods.

EFT

When using the transactionDeposit query you need to include the token ID of the current user to ensure the correct deposit reference is returned.

query transactionDeposit{
  transactionDeposit(tokenId: "1LmSTMO37LClxXAQddVgMf") {
    name
    number
    branch
    type
    reference
  }
}

Instant EFT

For instant eft the OZOW method is used.

mutation transactionDeposit {
  transactionDeposit(id: "4HWcYM0smxYXJZvXQLukTN", method: "OZOW") {
    id
    value
    processed
    paymentLink
  }
}

Response

{
    "data": {
        "transactionDeposit": {
            "id": "4qBQREsczTqdcHJZ9yoSSO",
            "value": 538.12,
            "processed": null,
            "paymentLink": "https:\/\/pay.ozow.com\/c80053cb-590e-4dc5-9e85-8e959f6729d6\/Secure"
        }
    }
}

Debit/Credit Card

For card payments the ECEN method is used.

{info} For testing the credit card gateway we have a list of card numbers that are available on request by contacting support@tradesafe.co.za.

mutation transactionDeposit {
  transactionDeposit(id: "4HWcYM0smxYXJZvXQLukTN", method: "ECEN") {
    id
    value
    processed
    paymentLink
  }
}

Response

{
    "data": {
        "transactionDeposit": {
            "id": "3WDqBie3b3VnuF3vZnU202",
            "value": 547.25,
            "processed": null,
            "paymentLink": "https:\/\/app-developer.tradesafe.dev\/api\/ecentric\/redirect\/3WDqBie3b3VnuF3vZnU202"
        }
    }
}

SnapScan

For SnapScan the SNAP method is used.

mutation transactionDeposit {
  transactionDeposit(id: "4HWcYM0smxYXJZvXQLukTN", method: "SNAP") {
    id
    value
    processed
    paymentLink
  }
}

Response

{
    "data": {
        "transactionDeposit": {
            "id": "2HDE7Pb32KsxAvvR4Clww0",
            "value": 550.29,
            "processed": null,
            "paymentLink": "https:\/\/pos.snapscan.io\/qr\/TEST_TRADE_ESCROW?id=SNAPSNAPOKNS8GFH&amount=550.29"
        }
    }
}