--- swagger: "2.0" info: x-ibm-name: collection title: Collection version: 1.0.0 description: "" schemes: - https basePath: /collection consumes: - application/json produces: - application/json securityDefinitions: Secret: type: apiKey description: "" in: header name: X-IBM-Client-Secret clientIdHeader: type: apiKey in: header name: X-IBM-Client-Id security: - clientIdHeader: [] Secret: [] x-ibm-configuration: testable: true enforced: true phase: realized paths: /CancelRegister: post: responses: 200: description: 200 OK /RegisterInq: post: responses: 200: description: 200 OK /Register: parameters: - name: payload required: false in: body schema: $ref: '#/definitions/PaymentCollectionRegisterRequest' post: responses: 200: description: 200 OK /CollInq: parameters: - name: payload required: false in: body schema: $ref: '#/definitions/PaymentCollectionInqRequest' post: responses: 200: description: 200 OK /CollAdd: parameters: - name: payload required: false in: body schema: $ref: '#/definitions/PaymentCollectionAddRequest' post: responses: 200: description: 200 OK definitions: PaymentCollectionAddRequest: description: "" type: object properties: requestId: type: string description: So Id request duy nhat cua doi tac gui sang providerId: type: string description: Ma nha cung cap dich vụ do VietinBank cung cap merchantId: type: string description: Ma chi nhanh/dai ly/thiet bị/app cua doi ta do VietinBank cung cap transTime: type: string description: Thoi gian doi tac gui yeu cau sendRecord: type: string description: So Luong ban ghi gui theo lo records: description: Ban ghi $ref: '#/definitions/RecordsPayAddReqest' remittanceType: type: string description: 'Hinh thuc chuyen tien VD 0 : trong he thong, 1 : ngoai he thong qua Napas, 2 : ngoai he thong qua citad/song phuong, 3 : giay to tuy than' feeType: type: string description: Thong tin loai phi verifyByBank: type: string description: Y/N (su dung phuong thuc xac thuc do bank cung cap) execUserID: type: string description: Ma User thuc hien chi ho phia doi tac verifyMethod: type: string description: 'Phuong thuc dung de xac thuc. VD: RSA' verifyInfor: type: string description: 'Thong tin xac thuc, VD: RSA OTP' clientIP: type: string description: IP cua doi tac goi API channel: type: string description: Ma kenh thuc hien giao dich, VD MOBILE, WEB, POS, DESKTOP version: type: string description: "Version cua API\tVD: 1.0.1" language: type: string description: 'Ngon ngu su dung VD: vi, en' signature: type: string description: Chu ky so example: | { "requestId":"", "providerId":"", "merchantId":"", "transTime":"", "sendRecord":"", "records": [ { "transId":"", "priority":"", "senderBankId":"", "senderBranchId":"", "senderAcctId":"", "senderAcctName":"", "senderAddr":"", "senderCity":"", "senderCountry":"", "recvBankId":"", "recvBranchId":"", "recvAcctId":"", "recvAcctName":"", "recvAddr":"", "recvCity":"", "recvCountry":"", "recvIdCard":"", "recvIdIssueDate":"", "recvIdIssueBy":"", "recvPhoneNo":"", "recvEmail":"", "amount":"", "currencyCode":"", "payRefNo":"", "payRefInfor":"", "remark":"" } ], "remittanceType":"", "feeType":"", "verifyByBank":"", "execUserID":"", "verifyMethod":"", "verifyInfor":"", "clientIP":"", "channel":"", "version":"", "language":"", "signature":"" } RecordsPayAddReqest: description: "" type: object properties: transId: type: string description: Id cua giao dich chi tiet trong lo priority: type: string description: Do uu tien tu 1-9 senderBankId: type: string description: Ma Bank cua nguoi chuyen senderBranchId: type: string description: Ma chi nhanh cua nguoi chuyen senderAcctId: type: string description: So tai khoan cua nguoi chuyen senderAcctName: type: string description: Ten tai khoan cua nguoi chuyen (Tieng viet khong dau) senderAddr: type: string description: Di chi cua nguoi chuyen senderCity: type: string description: Thanh pho cua nguoi chuyen senderCountry: type: string description: Quoc gia cua nguoi chuyen recvBankId: type: string description: Ma Bank cua tai khoan thu huong recvBranchId: type: string description: Ma chi nhanh cua tai khoan thu huong recvAcctId: type: string description: So tai khoan/so the nguoi thu huong recvAcctName: type: string description: Ten tai khoan/the nguoi thu huong recvAddr: type: string description: Dia chi cua nguoi nhan recvCity: type: string description: Thanh pho cua nguoi nhan recvCountry: type: string description: Quoc gia cua nguoi nhan recvIdCard: type: string description: So CMT/Ho chieu cua nguoi thu huong recvIdIssueDate: type: string description: Noi cap CMT/Ho chieu cua nguoi thu huong recvIdIssueBy: type: string description: Ngay cap CMT/Ho chieu cua nguoi thu huong recvPhoneNo: type: string description: So dien thoai cua nguoi thu huong recvEmail: type: string description: Dia chi email cua nguoi thu huong amount: type: string description: So tien chi ho currencyCode: type: string description: Ma tien te payRefNo: type: string description: Ma KH cua doi tac payRefInfor: type: string description: Thong tin bo sung cua chi ho ( ky cuoc, ky thanh toan...) remark: type: string description: Ghi chu them cho giao dich example: |- { "transId":"", "priority":"", "senderBankId":"", "senderBranchId":"", "senderAcctId":"", "senderAcctName":"", "senderAddr":"", "senderCity":"", "senderCountry":"", "recvBankId":"", "recvBranchId":"", "recvAcctId":"", "recvAcctName":"", "recvAddr":"", "recvCity":"", "recvCountry":"", "recvIdCard":"", "recvIdIssueDate":"", "recvIdIssueBy":"", "recvPhoneNo":"", "recvEmail":"", "amount":"", "currencyCode":"", "payRefNo":"", "payRefInfor":"", "remark":"" } PaymentCollectionInqRequest: description: "" type: object properties: requestId: type: string providerId: type: string merchantId: type: string originalRequestId: type: string transId: type: string transTime: type: string channel: type: string version: type: string language: type: string clientIP: type: string signature: type: string example: |- { "requestId":"", "providerId":"", "merchantId":"", "originalRequestId":"", "transId":"", "transTime":"", "channel":"", "version":"", "language":"", "clientIP":"", "signature":"" } PaymentCollectionRegisterRequest: description: "" type: object properties: requestId: type: string providerId: type: string merchantId: type: string bankAccount: type: string payRefNo: type: string payRefInfor: type: string customerName: type: string idCard: type: string phoneNo: type: string email: type: string address: type: string taxCode: type: string scheduleType: type: string schedulePeriod: type: string transTime: type: string clientIP: type: string channel: type: string version: type: string language: type: string signature: type: string example: '{ "requestId":"VNPT1577878788", "providerId":"123", "merchantId":"1001", "bankAccount":"1577878788", "payRefNo":" VN12989", "payRefInfor":" 1342344", "customerName":"NGUYEN VAN A", "idCard":"83472393", "phoneNo":"0988029039", "email":"nguyenvana@gmail.com", "address":"505 Minh Khai, HBT, Ha Noi, VN", "taxCode":"249384384", "scheduleType":"MONTHLY", "schedulePeriod":"20180418", "transTime":"20170519134551", "clientIP":"192.168.4.5", "channel":"MOBILE", "version":"1.0", "language":"vi", "signature":"" }' PaymentCollectionRegisterInqRequest: description: "" type: object properties: requestId: type: string providerId: type: string merchantId: type: string originalRequestId: type: string payRefNo: type: string regId: type: string transTime: type: string channel: type: string version: type: string language: type: string clientIP: type: string signature: type: string example: '{ "requestId" : "4278487569", "providerId" : "123", "merchantId" : "1001", "originalRequestId" : "12313", "payRefNo" : "12000", "regId" : "12321", "transTime" : "20170522101211", "channel" : "MOBILE", "version" : "1.0", "language" : "vi", "clientIP" : "192.168.3.4", "signature" : "" }' PaymentCollectionCancelRegisterRequest: description: "" type: object properties: requestId: type: string providerId: type: string merchantId: type: string payRefNo: type: string regId: type: string transTime: type: string channel: type: string version: type: string language: type: string clientIP: type: string signature: type: string example: '{ "requestId":"4278487329", "providerId":"123", "merchantId":"1001", "payRefNo": "2434343", "regId": "1234", "transTime" : "20170522101211", "channel" : "MOBILE", "version" : "1.0", "language" : "vi", "clientIP" : "192.168.3.4", "signature" : "" }' tags: [] x-ibm-endpoints: - endpointUrl: https://sandbox.vietinbank.vn description: Environment for SANDBOX type: - production - development ...