{ "info": { "_postman_id": "da83139e-e8b0-4d2e-9ed5-a1800263c872", "name": "Tilt Pay - Client pack (IMT)", "description": "### Introduction\nSend transfers and collect payments through the Tilt platform by using the Tilt Pay API.\n\nThe Tilt Pay API is based on REST with resource-oriented URLs. It accepts form-encoded request bodies and returns JSON-encoded responses with standard HTTP response codes.\n\nContact Support:\n Name: Tilt", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "4891901", "_collection_link": "https://go.postman.co/collection/4891901-da83139e-e8b0-4d2e-9ed5-a1800263c872?source=collection_link" }, "item": [ { "name": "Authorization", "item": [ { "name": "Get token", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Got bearer access_token\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.access_token).to.not.be.empty;", " pm.expect(jsonData.token_type).to.eql('Bearer');", "});", "", "var jsonData = JSON.parse(responseBody);", "postman.setEnvironmentVariable(\"bearerToken\", jsonData.access_token);" ], "type": "text/javascript" } } ], "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"username\": \"{{username}}\",\n \"password\": \"{{password}}\",\n \"audience\": \"{{audience}}\",\n \"grant_type\": \"password\",\n \"client_id\": \"{{client_id}}\"\n}" }, "url": { "raw": "{{baseAuthUrl}}/oauth/token", "host": [ "{{baseAuthUrl}}" ], "path": [ "oauth", "token" ] }, "description": "Use your username and password to obtain an access token which you need to use to authenticate your account when using the API." }, "response": [] } ] }, { "name": "Resources", "item": [ { "name": "List institutions for a country", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "var jsonData = pm.response.json();", "pm.test(\"Institutions returned correctly\", function () {", " pm.expect(jsonData.data).to.be.an(\"array\");", "});", "pm.test(\"Tilt institution present\", function () {", " const iname = pm.environment.get(\"account_institution\");", " const i = jsonData.data.find(m => m.id === iname);", " pm.expect(i).to.be.an(\"object\", iname + \" institution not found in array\");", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/resources/institutions/:country/?list=true", "host": [ "{{baseUrl}}" ], "path": [ "v1", "resources", "institutions", ":country", "" ], "query": [ { "key": "type", "value": "bank", "disabled": true }, { "key": "list", "value": "true" } ], "variable": [ { "key": "country", "value": "{{country}}", "description": "Country in lowercase ISO 3166-1 alpha-2 format" } ] }, "description": "List available institutions for a country. Required for account verification and creating transfers." }, "response": [ { "name": "List institutions for a country", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/resources/institutions/:country/?list=true", "host": [ "{{baseUrl}}" ], "path": [ "v1", "resources", "institutions", ":country", "" ], "query": [ { "key": "type", "value": "bank", "disabled": true }, { "key": "list", "value": "true" } ], "variable": [ { "key": "country", "value": "gh", "description": "Country in lowercase ISO 3166-1 alpha-2 format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Tue, 24 Sep 2024 08:51:07 GMT" }, { "key": "Content-Type", "value": "application/json; charset=utf-8" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Connection", "value": "keep-alive" }, { "key": "apigw-requestid", "value": "emiLWhh_joEEPWA=" }, { "key": "x-frame-options", "value": "DENY" }, { "key": "x-api-request-id", "value": "e2ccc336-f4cc-4317-b274-c6219c407a82" }, { "key": "x-api-name", "value": "Tilt Pay" }, { "key": "x-api-version", "value": "0.64.4" }, { "key": "CF-Cache-Status", "value": "DYNAMIC" }, { "key": "Report-To", "value": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=KpajTaW%2FJLqOjDCQLjrEYKH8h1XqdYdTQiCOthqLTG310fa8VM%2BoDI%2FdYYQUc2U2P0b2cbPKMcUmje1ufppUQF9CbgxIZgmIOjAsXe9B2RxDG0x4%2F0mW%2BrBBdRr7hSUFXlzt3200jtl1\"}],\"group\":\"cf-nel\",\"max_age\":604800}" }, { "key": "NEL", "value": "{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}" }, { "key": "Server", "value": "cloudflare" }, { "key": "CF-RAY", "value": "8c8187e3cc4681c4-IAD" }, { "key": "Content-Encoding", "value": "br" } ], "cookie": [], "body": "{\n \"responseCode\": 200,\n \"responseMessage\": \"Fetched institutions\",\n \"data\": {\n \"gh_tilt\": \"Tilt Ghana\",\n \"gh_absa\": \"Absa Bank Ghana Limited\",\n \"gh_access\": \"Access Bank\",\n \"gh_adb\": \"Agricultural Development Bank\",\n \"gh_airtel\": \"Airtel Money\",\n \"gh_cal\": \"Cal Bank\",\n \"gh_cbg\": \"Consolidated Bank Ghana Limited (CBG)\",\n \"gh_ecobank\": \"Ecobank\",\n \"gh_fidelity\": \"Fidelity Bank\",\n \"gh_fab\": \"First Atlantic Bank Ltd\",\n \"gh_fnb\": \"First National Bank\",\n \"gh_gcb\": \"Gcb Bank Ltd\",\n \"gh_guaranty\": \"Guaranty Trust Bank\",\n \"gh_mtn\": \"MTN Mobile Money\",\n \"gh_nib\": \"National Investment Bank\",\n \"gh_prudential\": \"Prudential Bank\",\n \"gh_republic\": \"Republic Bank Ghana\",\n \"gh_stanbic\": \"Stanbic Bank\",\n \"gh_stanchart\": \"Standard Chartered Bank\",\n \"gh_tigo\": \"Tigo Money\",\n \"gh_uba\": \"United Bank for Africa\",\n \"gh_umb\": \"Universal Merchant Bank\",\n \"gh_vodafone\": \"Vodafone Money\",\n \"gh_zenith\": \"Zenith Bank\",\n \"gh_adehyeman\": \"ADEHYEMAN SAVINGS AND LOANS\",\n \"gh_arb\": \"ARB Apex Bank/Rural & Community Banks\",\n \"gh_bestpoint\": \"BESTPOINT SAVINGS AND LOANS\",\n \"gh_boa\": \"Bank Of Africa\",\n \"gh_bog\": \"BANK OF GHANA\",\n \"gh_etranzact\": \"eTranzact\",\n \"gh_fbn\": \"FBN Bank (Ghana)\",\n \"gh_ghanapay\": \"GHANAPAY\",\n \"gh_gmoney\": \"G-MONEY\",\n \"gh_oisl\": \"Opportunity International Savings and Loans- OISL\",\n \"gh_omnibsic\": \"OMNIBSIC Bank\",\n \"gh_sg\": \"SOCIETE GENERALE GHANA LTD\",\n \"gh_sinapiaba\": \"SINAPI ABA SAVINGS AND LOANS\",\n \"gh_sisl\": \"SERVICES INTEGRITY SAVINGS & LOANS\",\n \"gh_slydepay\": \"SLYDEPAY\",\n \"gh_zeepay\": \"ZeePay Ghana Limited\",\n \"gh_affinity\": \"AFFINITY GHANA SAVINGS AND LOANS\",\n \"gh_expresspay\": \"EXPRESSPAY\",\n \"gh_kowri\": \"KOWRI\",\n \"gh_letshego\": \"LETSHEGO SAVINGS AND LOANS\",\n \"gh_moolre\": \"MOOLRE LIMITED\",\n \"gh_payswitch\": \"PAYSWITCH\",\n \"gh_remcash\": \"REMCASH\",\n \"gh_unity\": \"UNITY LINK\"\n }\n}" } ] } ] }, { "name": "FX", "item": [ { "name": "Get FX rate", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/rates/fx/:from_currency/:to_currency", "host": [ "{{baseUrl}}" ], "path": [ "v1", "rates", "fx", ":from_currency", ":to_currency" ], "variable": [ { "key": "from_currency", "value": "usd" }, { "key": "to_currency", "value": "ngn" } ] } }, "response": [ { "name": "200", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/rates/fx/:from_currency/:to_currency", "host": [ "{{baseUrl}}" ], "path": [ "v1", "rates", "fx", ":from_currency", ":to_currency" ], "variable": [ { "key": "from_currency", "value": "usd" }, { "key": "to_currency", "value": "ngn" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": ":status", "value": 200 }, { "key": "date", "value": "Fri, 08 Nov 2024 11:13:41 GMT" }, { "key": "content-type", "value": "application/json; charset=utf-8" }, { "key": "apigw-requestid", "value": "A7LP3hPfjoEEMrA=" }, { "key": "x-frame-options", "value": "DENY" }, { "key": "x-api-request-id", "value": "307d4290-22b4-4f1b-872b-54616b8ff29f" }, { "key": "x-api-name", "value": "Tilt Pay" }, { "key": "x-api-version", "value": "0.67.10" }, { "key": "cf-cache-status", "value": "DYNAMIC" }, { "key": "report-to", "value": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=ZyDK8DS5gEW%2FlBT%2F0wnkgvrN1ktQK6QdBL9090HK26La827KP9j310Js%2F2I%2Biq3vr%2BfAozk14lVwPEYGHSfBsxeuTqxu9Xj0u9EiTVFurdG4x2vKSl6v0Ki0GAbi0VXSIaknOXrwBkyF\"}],\"group\":\"cf-nel\",\"max_age\":604800}" }, { "key": "nel", "value": "{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}" }, { "key": "server", "value": "cloudflare" }, { "key": "cf-ray", "value": "8df522956ff80542-JNB" }, { "key": "content-encoding", "value": "br" }, { "key": "server-timing", "value": "cfL4;desc=\"?proto=TCP&rtt=20111&sent=11&recv=13&lost=0&retrans=2&sent_bytes=3944&recv_bytes=2728&delivery_rate=192182&cwnd=252&unsent_bytes=0&cid=4e2684bd2a7aef62&ts=987&x=0\"" } ], "cookie": [], "body": "{\n \"responseCode\": 200,\n \"responseMessage\": \"Fetched currency exchange rate\",\n \"data\": {\n \"from\": {\n \"currency\": \"usd\"\n },\n \"to\": {\n \"currency\": \"ngn\"\n },\n \"rate\": 1750.6489495892\n }\n}" } ] } ] }, { "name": "Your account", "item": [ { "name": "Fetch account balance", "event": [ { "listen": "test", "script": { "exec": [ "var jsonData = pm.response.json();", "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", " pm.expect(jsonData.responseMessage).to.eql(\"Fetched account balance\");", "});", "pm.test(\"Balance returned\", function () {", " pm.expect(jsonData.data.balance).to.be.an(\"number\");", " pm.expect(jsonData.data.currency).to.be.an(\"string\");", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number/balance", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number", "balance" ], "variable": [ { "key": "institution", "value": "{{account_institution}}", "description": "(Required) " }, { "key": "account_number", "value": "{{account_number}}" } ] }, "description": "Gets the real-time balance of an account that the requesting client has permission to view." }, "response": [] }, { "name": "List transactions", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "var jsonData = pm.response.json();", "pm.test(\"Transactions should be an array\", function () {", " pm.expect(jsonData.data.count).to.be.an(\"number\");", " pm.expect(jsonData.data.transactions).to.be.an(\"array\");", "});" ], "type": "text/javascript", "packages": {} } } ], "protocolProfileBehavior": { "disabledSystemHeaders": { "accept": true } }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "description": "Request a specific content-type for the response" } ], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number/transactions?to_datetime=2024-07-11T00:00:00+0000&from_datetime=2024-07-09T00:00:00+0000", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number", "transactions" ], "query": [ { "key": "to_datetime", "value": "2024-07-11T00:00:00+0000" }, { "key": "from_datetime", "value": "2024-07-09T00:00:00+0000" } ], "variable": [ { "key": "institution", "value": "{{account_institution}}" }, { "key": "account_number", "value": "{{account_number}}" } ] }, "description": "The transactions resource can be used to retrieve transaction data for an account that the requesting client has permission to view.\n\nTransaction data is available up to 90 days, after which historical data will need to be requested from your account manager.\n\nOpening and closing balances are calculated nightly and are not available for transactions on the current day.\n\nUse the Accept header to specify the response format, such as `text/csv`." }, "response": [] }, { "name": "List available statements", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "var jsonData = pm.response.json();", "pm.test(\"Statements returned\", function () {", " pm.expect(jsonData.data).to.be.an(\"array\");", " pm.expect(jsonData.data[0].statement_id).to.not.be.empty;", " pm.expect(jsonData.data[0].opening_balance).to.be.a('number')", " pm.expect(jsonData.data[0].closing_balance).to.be.a('number')", " pm.expect(jsonData.data[0].transactions_count).to.be.a('number');", "});", "pm.test(\"A statement is present\", function () {", " pm.expect(jsonData.data).to.be.an(\"array\");", " pm.expect(jsonData.data[0].statement_id).to.not.be.empty;", " pm.expect(jsonData.data[0].opening_balance).to.be.a('number')", " pm.expect(jsonData.data[0].closing_balance).to.be.a('number')", " pm.expect(jsonData.data[0].transactions_count).to.be.a('number');", "});", "", "pm.collectionVariables.set(\"__statement_id\", pm.response.json().data[0].statement_id);" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number/statements", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number", "statements" ], "query": [ { "key": "from_datetime", "value": "2022-05-01T00:00:00", "description": "Specifies start date and time for filtering of the statements. If this is not populated, the start date will be open ended", "disabled": true }, { "description": "Specifies end date and time for filtering of the statement. If this is not populated, the end date will be open ended", "key": "to_datetime", "value": "2022-025-07T13:00:00Z", "disabled": true }, { "key": "search", "value": "weekly", "type": "text", "disabled": true } ], "variable": [ { "key": "institution", "value": "{{account_institution}}" }, { "key": "account_number", "value": "{{account_number}}" } ] }, "description": "The statements resource can be used to retrieve a list of available statements for an account that the requesting client has permission to view.\n\nStatement transaction data can then be fetched from the referenced link as it will not be included when listing statements." }, "response": [] }, { "name": "Fetch an account statement", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", " pm.expect(pm.response.json().responseMessage).to.eql('Fetched statement');", "});", "pm.test(\"A statement is present\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data).to.be.an(\"object\");", " pm.expect(jsonData.data.statement_id).to.eql(pm.collectionVariables.get('__statement_id'));", " pm.expect(jsonData.data.account).to.eql(pm.environment.get('account_number'));", " pm.expect(jsonData.data.institution).to.eql(pm.environment.get('account_institution'));", " pm.expect(jsonData.data.opening_balance).to.be.a('number');", " pm.expect(jsonData.data.closing_balance).to.be.a('number');", " pm.expect(jsonData.data.transactions_count).to.be.a('number');", " pm.expect(jsonData.data.transactions).to.be.an(\"array\");", "});" ], "type": "text/javascript" } } ], "protocolProfileBehavior": { "disabledSystemHeaders": { "accept": true } }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "text/csv", "disabled": true } ], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number/statements/:statement_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number", "statements", ":statement_id" ], "variable": [ { "key": "institution", "value": "{{account_institution}}", "description": "(Required) " }, { "key": "account_number", "value": "{{account_number}}", "description": "(Required) " }, { "key": "statement_id", "value": "{{__statement_id}}" } ] }, "description": "The statements resource can be used to retrieve a specific statement if the requesting client has permission to view the related account.\n\nStatement transaction data will be included in the response if available or a link will be provided to an archived statement where available.\n\nTransaction data is generally available for 90 days before being archived.\n\nUse the Accept header to specify the response format, such as `text/csv`." }, "response": [] }, { "name": "Account Withdrawal", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Successful POST request\", function () {", " pm.expect(pm.response.code).to.be.oneOf([200, 201]);", "});", "pm.test(\"Transfer returned and correct\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.not.be.empty;", " pm.expect(jsonData.data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "pm.test(\"Actions returned correctly\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.actions).to.be.an(\"array\");", " const action = jsonData.data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", " pm.expect(action._meta.cause).to.not.be.empty;", " pm.expect(action._meta.trace_api_log_id).to.not.be.empty;", " //pm.expect(action._meta.financial_transaction_log_id).to.not.be.empty;", "});", "" ], "type": "text/javascript" } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"amount\": 100,\n \"narration\": \"Send to bank test\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"https://webhook.site/xxx\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number/withdraw", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number", "withdraw" ], "variable": [ { "key": "institution", "value": "{{account_institution}}" }, { "key": "account_number", "value": "{{account_number}}" } ] }, "description": "Create a transfer" }, "response": [] } ] }, { "name": "Lookup recipient account", "item": [ { "name": "Lookup account", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Account matches expected results\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.institution).to.eql(pm.environment.get('recipient_institution'));", " pm.expect(jsonData.data.account_number).to.eql(pm.request.toJSON().url.path[4]);", " pm.expect(jsonData.data.status).to.not.be.empty;", " //todo", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number" ], "variable": [ { "key": "institution", "value": "{{recipient_institution}}", "description": "(Required) Institution identifier as found in the institution api\n" }, { "key": "account_number", "value": "{{recipient_account}}" } ] }, "description": "Fetch information for an account number if the institution supports account discovery." }, "response": [] } ] }, { "name": "Send IMT (auto-accept quote)", "item": [ { "name": "Send", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Successful POST request\", function () {", " pm.expect(pm.response.code).to.be.oneOf([200, 201]);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.not.be.empty;", " pm.expect(jsonData.data.status).to.not.be.empty;", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "pm.test(\"Transfer is pending\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.status).to.equal('PENDING');", "});", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);", "" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_absa\",\n \"account_number\": \"123456\",\n \"mobile_number\": \"260960000001\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"test\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Verify that transfer was created", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.not.be.empty;", " pm.expect(jsonData.responseMessage).to.equal('A request has been received for this external_transaction_id');", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);", "" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/transfers/verify/:external_transaction_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", "verify", ":external_transaction_id" ], "variable": [ { "key": "external_transaction_id", "value": "{{__external_transaction_id}}", "description": "(Required) " } ] }, "description": "Verify if a particular external transaction id has been received and processed by Tilt" }, "response": [] }, { "name": "Fetch transfer by id", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.eql(pm.collectionVariables.get(\"__transfer_id\"));", " pm.expect(jsonData.responseMessage).to.equal('Fetched transfer');", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "", "pm.test(\"Last action present\", function () {", " const action = pm.response.json().data.actions.pop();", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.actions).to.be.an(\"array\");", " pm.expect(action).to.be.an(\"object\", \"last action not found\");", " pm.expect(action.status).to.eql(jsonData.data.status);", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/transfers/:transfer_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", ":transfer_id" ], "variable": [ { "key": "transfer_id", "value": "{{__transfer_id}}", "description": "(Required) Transfer ID issued by the platform" } ] }, "description": "Fetch a transfer using transfer_id issued by Tilt" }, "response": [] }, { "name": "Resend last webhook", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "var jsonData = pm.response.json();", "pm.test(\"response present\", function () {", " pm.expect(jsonData.data.response.http_code).to.exist;", "});", "pm.test(\"webhook present\", function () {", " pm.expect(jsonData.data.webhook.request_id).to.not.be.empty;", " pm.expect(jsonData.data.webhook.url).to.not.be.empty;", " pm.expect(jsonData.data.webhook.message).to.not.be.empty;", "});" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/transfers/:transfer_id/resend-notification", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", ":transfer_id", "resend-notification" ], "variable": [ { "key": "transfer_id", "value": "{{__transfer_id}}" } ] }, "description": "Fetch a payment using payment_id issued by Tilt" }, "response": [] } ], "description": "The Transfers API allows you to send money directly into a recipient's account" }, { "name": "Quote and Send IMT", "item": [ { "name": "Quote", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Successful POST request\", function () {", " pm.expect(pm.response.code).to.be.oneOf([200, 201]);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.not.be.empty;", " pm.expect(jsonData.data.status).to.not.be.empty;", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "pm.test(\"Transfer is pending\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.status).to.equal('PENDING');", "});", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);", "" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_absa\",\n \"account_number\": \"123456\",\n \"mobile_number\": \"260960000001\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"test\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers/quote", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", "quote" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send quoted transfer", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Successful request\", function () {", " pm.expect(pm.response.code).to.be.oneOf([200, 201]);", "});" ], "type": "text/javascript" } }, { "listen": "prerequest", "script": { "exec": [ "" ], "type": "text/javascript" } } ], "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "url": { "raw": "{{baseUrl}}/v1/transfers/:transfer_id/settle", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", ":transfer_id", "settle" ], "variable": [ { "key": "transfer_id", "value": "{{__transfer_id}}" } ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Verify that transfer was created", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.not.be.empty;", " pm.expect(jsonData.responseMessage).to.equal('A request has been received for this external_transaction_id');", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);", "" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/transfers/verify/:external_transaction_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", "verify", ":external_transaction_id" ], "variable": [ { "key": "external_transaction_id", "value": "{{__external_transaction_id}}", "description": "(Required) " } ] }, "description": "Verify if a particular external transaction id has been received and processed by Tilt" }, "response": [] }, { "name": "Fetch transfer by id", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "pm.test(\"Transfer returned\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.transfer_id).to.eql(pm.collectionVariables.get(\"__transfer_id\"));", " pm.expect(jsonData.responseMessage).to.equal('Fetched transfer');", " pm.expect(jsonData.data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(jsonData.data.instruction.debtor).to.not.be.empty;", " pm.expect(jsonData.data.instruction.creditor).to.not.be.empty;", " pm.expect(jsonData.data.actions).to.not.be.empty;", "});", "", "pm.test(\"Last action present\", function () {", " const action = pm.response.json().data.actions.pop();", " var jsonData = pm.response.json();", " pm.expect(jsonData.data.actions).to.be.an(\"array\");", " pm.expect(action).to.be.an(\"object\", \"last action not found\");", " pm.expect(action.status).to.eql(jsonData.data.status);", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/transfers/:transfer_id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", ":transfer_id" ], "variable": [ { "key": "transfer_id", "value": "{{__transfer_id}}", "description": "(Required) Transfer ID issued by the platform" } ] }, "description": "Fetch a transfer using transfer_id issued by Tilt" }, "response": [] }, { "name": "Resend last webhook", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "var jsonData = pm.response.json();", "pm.test(\"response present\", function () {", " pm.expect(jsonData.data.response.http_code).to.exist;", "});", "pm.test(\"webhook present\", function () {", " pm.expect(jsonData.data.webhook.request_id).to.not.be.empty;", " pm.expect(jsonData.data.webhook.url).to.not.be.empty;", " pm.expect(jsonData.data.webhook.message).to.not.be.empty;", "});" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/transfers/:transfer_id/resend-notification", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers", ":transfer_id", "resend-notification" ], "variable": [ { "key": "transfer_id", "value": "{{__transfer_id}}" } ] }, "description": "Fetch a payment using payment_id issued by Tilt" }, "response": [] } ], "description": "The Transfers API allows you to send money directly into a recipient's account" }, { "name": "Mock Samples", "item": [ { "name": "Lookup recipient", "item": [ { "name": "Success", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number" ], "variable": [ { "key": "institution", "value": "zm_airtel", "description": "(Required) Institution identifier as found in the institution api\n" }, { "key": "account_number", "value": "260970000100", "description": "(Required) Account number (or mobile number for wallet) to lookup" } ] }, "description": "Fetch information for an account number if the institution supports account discovery." }, "response": [] }, { "name": "Account not found", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number" ], "variable": [ { "key": "institution", "value": "zm_airtel", "description": "(Required) Institution identifier as found in the institution api\n" }, { "key": "account_number", "value": "0970000600", "description": "(Required) Account number (or mobile number for wallet) to lookup" } ] }, "description": "Fetch information for an account number if the institution supports account discovery." }, "response": [] }, { "name": "Institution error", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/accounts/:institution/:account_number", "host": [ "{{baseUrl}}" ], "path": [ "v1", "accounts", ":institution", ":account_number" ], "variable": [ { "key": "institution", "value": "zm_airtel", "description": "(Required) Institution identifier as found in the institution api\n" }, { "key": "account_number", "value": "0970000700", "description": "(Required) Account number (or mobile number for wallet) to lookup" } ] }, "description": "Fetch information for an account number if the institution supports account discovery." }, "response": [] } ] }, { "name": "Send IMT", "item": [ { "name": "Send - SUCCESSFUL", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_absa\",\n \"account_number\": \"123456\",\n \"mobile_number\": \"260960000001\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock success\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send - FAILED (institution error)", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_fnb\",\n \"account_number\": \"100500\",\n \"mobile_number\": \"260960000001\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock failed\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send - FAILED (account not found)", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_absa\",\n \"account_number\": \"100600\",\n \"mobile_number\": \"260960000001\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock failed\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send - FAILED (account error)", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_mtn\",\n \"account_number\": \"0961000700\",\n \"mobile_number\": \"260961000700\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock failed\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send - PENDING > SUCCESSFUL", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_mtn\",\n \"account_number\": \"0961000200\",\n \"mobile_number\": \"260961000200\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock pending > success\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] }, { "name": "Send - PENDING > FAILED", "event": [ { "listen": "test", "script": { "exec": [ "pm.test('Successful response', function () {", " pm.expect(pm.response.code).to.be.oneOf([", " 200,", " 201", " ]);", "});", "", "pm.test(\"Transfer data OK\", function () {", " pm.expect(pm.response.json().data.transfer_id).to.not.be.empty;", " pm.expect(pm.response.json().data.status).to.equal('SUCCESSFUL');", " //pm.expect(jsonData.responseMessage).to.equal('Transfer successful');", " pm.expect(pm.response.json().data.external_transaction_id).to.eql(pm.collectionVariables.get('__external_transaction_id'));", " pm.expect(pm.response.json().data.instruction.debtor).to.not.be.empty;", " pm.expect(pm.response.json().data.instruction.creditor).to.not.be.empty;", "});", "", "pm.test(\"Actions returned correctly\", function () {", " pm.expect(pm.response.json().data.actions).to.be.an(\"array\");", " const action = pm.response.json().data.actions.find(m => m.status === 'SUCCESSFUL');", " pm.expect(action).to.be.an(\"object\", \"SUCCESSFUL action not found\");", "});", "", "pm.collectionVariables.set(\"__transfer_id\", pm.response.json().data.transfer_id);" ], "type": "text/javascript", "packages": {} } }, { "listen": "prerequest", "script": { "exec": [ "pm.collectionVariables.set(\"__external_transaction_id\", require('uuid').v4());" ], "type": "text/javascript", "packages": {} } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Content-Type", "value": "application/json", "disabled": true } ], "body": { "mode": "raw", "raw": "{\n \"instruction\": {\n \"debtor\": {\n \"institution\": \"{{account_institution}}\",\n \"account_number\": \"{{account_number}}\",\n \"kyc\": {\n \"first_name\": \"Roy\",\n \"last_name\": \"Milner\",\n \"id_number\": \"111111\",\n \"id_type\": \"passport\",\n \"address\": \"address\",\n \"country\": \"us\"\n }\n },\n \"creditor\": {\n \"institution\": \"zm_mtn\",\n \"account_number\": \"0961000300\",\n \"mobile_number\": \"260961000300\",\n \"kyc\": {\n \"first_name\": \"Tanya\",\n \"last_name\": \"Winslow\",\n \"id_number\": \"222222222\",\n \"id_type\": \"national_id\"\n }\n },\n \"additional_details\": {\n \"purpose_of_funds\": \"GIFT_AND_DONATION\",\n \"origin_currency\": \"usd\",\n \"origin_amount\": \"50\"\n },\n \"amount\": 1000,\n \"currency\": \"zmw\",\n \"narration\": \"mock pending > failed\",\n \"external_transaction_id\": \"{{__external_transaction_id}}\",\n \"scheme\": \"imt_transfer\",\n \"notifications\": [\n {\n \"on_status\": [\n \"ACCEPTED\",\n \"QUOTED\",\n \"QUOTE_EXPIRED\",\n \"PENDING\",\n \"PENDING_KYC\",\n \"KYC_EXPIRED\",\n \"SUCCESSFUL\",\n \"FAILED\"\n ],\n \"to_url\": \"\"\n }\n ]\n }\n}" }, "url": { "raw": "{{baseUrl}}/v1/transfers", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transfers" ] }, "description": "Create a transfer" }, "response": [] } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "" ] } } ], "variable": [ { "key": "__external_transaction_id", "value": "" }, { "key": "__transfer_id", "value": "" }, { "key": "__statement_id", "value": "" } ] }