Changes for page card-transaction
Last modified by David Persson on 2024/02/21 07:48
From version 11.1
edited by David Persson
on 2020/02/20 15:37
on 2020/02/20 15:37
To version 11.2
edited by David Persson
on 2020/02/21 01:52
on 2020/02/21 01:52
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -110,8 +110,7 @@ 110 110 |(% style="width:215px" %)sourceAuthorizationTransactionId|(% style="width:114px" %)string|(% style="width:118px" %)Maxlength: 50|(% style="width:586px" %)Unique identifier of the specific authorization, generated by source (typically the integrating system) 111 111 |(% style="width:215px" %)authorizationId|(% style="width:114px" %)string|(% style="width:118px" %)Maxlength: 6|(% style="width:586px" %)Unique identifier of the authorization, generated by PayEx. Should be stored and must be used in Purchase 112 112 |(% style="width:215px" %)sellerNumber|(% style="width:114px" %)string|(% style="width:118px" %)Maxlength: 15|(% style="width:586px" %)Identifier of the current seller/merchant 113 -|(% style="width:215px" %)cardToken|(% style="width:114px" %)string|(% style="width:118px" %) |(% style="width:586px" %)identifier of the card. The aurhotization is made on the account that the card is linked to 114 -|(% style="width:215px" %)accountNo|(% style="width:114px" %)string|(% style="width:118px" %) |(% style="width:586px" %)identifier of the account 113 +|(% style="width:215px" %)cardToken|(% style="width:114px" %)string|(% style="width:118px" %) |(% style="width:586px" %)Identifier of the card. The aurhotization is made on the account that the card is linked to 115 115 |(% style="width:215px" %)pointOfSale|(% style="width:114px" %)string|(% style="width:118px" %)Maxlength: 50|(% style="width:586px" %)Name of the location/point/shop of sale, will be returned in reservation resource 116 116 |(% style="width:215px" %)validToDate|(% style="width:114px" %)date|(% style="width:118px" %)[[ISO 8601>>url:http://en.wikipedia.org/wiki/ISO_8601||rel="noreferrer" title="ISO8601 on Wikipedia"]]|(% style="width:586px" %)Purchase can not be executed after this date 117 117 |(% style="width:215px" %)authorizeAmount|(% style="width:114px" %)decimal|(% style="width:118px" %)Amount|(% style="width:586px" %)Original authorized amount ... ... @@ -127,12 +127,13 @@ 127 127 ==== Post purchases ==== 128 128 129 129 {{code language="http" title="**Request**"}} 130 -POST /ledger/credit-account-acquiring/v1/XXX/ authorizations/NNN/purchases HTTP/1.1129 +POST /ledger/credit-account-acquiring/v1/XXX/purchases HTTP/1.1 131 131 Host: - 132 132 Authorization: Bearer <Token> 133 133 Content-Type: application/json 134 134 135 135 { 135 + "authorizationId" : "AUTH71", 136 136 "sourcePurchaseTransactionId" : "534313", 137 137 "sellerReceiptId": "2019-11-28", 138 138 "additionalReferences":{ ... ... @@ -139,7 +139,12 @@ 139 139 "acquirerBatchId": "fdsfsdfsd", 140 140 "acquirerTransactionId" : "534313" 141 141 }, 142 - "amount": 200.0 142 + "amount": 200.0, 143 + "offlineInfo" : { 144 + "pointOfSale": "Testshop", 145 + "cardToken": "5646735165", 146 + "sellerNumber": "654", 147 + } 143 143 } 144 144 {{/code}} 145 145 ... ... @@ -146,7 +146,7 @@ 146 146 ==== Get purchases ==== 147 147 148 148 {{code language="http" title="**Request**"}} 149 -GET /ledger/credit-account-acquiring/v1/XXX/ authorizations/NNN/purchases/YYY HTTP/1.1154 +GET /ledger/credit-account-acquiring/v1/XXX/purchases/YYY HTTP/1.1 150 150 Host: - 151 151 Authorization: Bearer <Token> 152 152 Content-Type: application/json ... ... @@ -156,7 +156,7 @@ 156 156 ==== List purchases ==== 157 157 158 158 {{code language="http" title="**Request**"}} 159 -GET /ledger/credit-account-acquiring/v1/XXX/ authorizations/NNN/purchases HTTP/1.1164 +GET /ledger/credit-account-acquiring/v1/XXX/purchases HTTP/1.1 160 160 Host: - 161 161 Authorization: Bearer <Token> 162 162 Content-Type: application/json ... ... @@ -171,21 +171,26 @@ 171 171 172 172 { 173 173 "description": "stora butiken test, köpref. 12345689", 179 + "authorizationId" : "AUTH71", 174 174 "sourcePurchaseTransactionId" : "534313", 181 + "sellerReceiptId": "2019-11-28", 175 175 "additionalReferences":{ 176 176 "acquirerBatchId": "fdsfsdfsd", 177 - "acquirerTransactionId" : "534313", 178 - }, 179 - "sellerReceiptId": "12345689", 180 - "amount": 200.0, 181 - "corrections": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY/corrections", 182 - "@id": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/Purchase/YYY", 183 - "parentHREF": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN", 184 + "acquirerTransactionId" : "534313" 185 + }, 186 + "amount": 200.0, 187 + "offlineInfo" : { 188 + "pointOfSale": "Testshop", 189 + "cardToken": "5646735165", 190 + "sellerNumber": "654", 191 + }, 192 + "corrections": "/ledger/credit-account-acquiring/v1/XXX/purchases/YYY/corrections", 193 + "@id": "/ledger/credit-account-acquiring/v1/XXX/purchases/YYY", 184 184 "operations": [ 185 185 { 186 186 "rel": "create-reversal", 187 187 "method": "post", 188 - "href": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY/r eversal"198 + "href": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY/corrections" 189 189 } 190 190 ] 191 191 } ... ... @@ -197,6 +197,7 @@ 197 197 |=(% style="width: 337px;" %)Property|=(% style="width: 121px;" %)Data type|=(% style="width: 164px;" %)Format|=(% style="width: 1156px;" %)Description 198 198 |(% style="width:337px" %)@id |(% style="width:121px" %)string|(% style="width:164px" %)Uri|(% style="width:1156px" %) 199 199 |(% style="width:337px" %)description|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 200|(% style="width:1156px" %)Describes the current Purchase (derives from info sent in the authorization), may be printed on the bill, output only 210 +|(% style="width:337px" %)authorizationId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 6|(% style="width:1156px" %)The id of the authorization from which this purchase originated from (not required if the purchase was made offline) 200 200 |(% style="width:337px" %)((( 201 201 (% style="background-color:transparent" %)sourcePurchaseTransactionId 202 202 )))|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Unique identifier of the Purchase transaction ... ... @@ -206,18 +206,114 @@ 206 206 |(% style="width:337px" %)additionalReferences.acquirerTransactionId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Unique acquirer identifier of the transaction 207 207 |(% style="width:337px" %)sellerReceiptId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %) 208 208 |(% style="width:337px" %)amount|(% style="width:121px" %)decimal|(% style="width:164px" %) |(% style="width:1156px" %) 220 +|(% style="width:337px" %)offlineInfo.pointOfSale|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Name of the location/point/shop of sale, will be returned in reservation resource 221 +|(% style="width:337px" %)offlineInfo.cardToken|(% style="width:121px" %)string|(% style="width:164px" %) |(% style="width:1156px" %)Identifier of the card. The purchase will be made on the account that the card is linked to 222 +|(% style="width:337px" %)offlineInfo.sellerNumber|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 15|(% style="width:1156px" %)Identifier of the current seller/merchant 209 209 |(% style="width:337px" %)corrections|(% style="width:121px" %)string|(% style="width:164px" %)Uri|(% style="width:1156px" %) 210 210 211 211 ---- 212 212 213 -== =Correction===227 +== Cash-withdrawals == 214 214 229 +==== Post cash-withdrawals ==== 230 + 231 +{{code language="http" title="**Request**"}} 232 +POST /ledger/credit-account-acquiring/v1/XXX/purchases HTTP/1.1 233 +Host: - 234 +Authorization: Bearer <Token> 235 +Content-Type: application/json 236 + 237 +{ 238 + "authorizationId" : "AUTH71", 239 + "sourcePurchaseTransactionId" : "534313", 240 + "sellerReceiptId": "2019-11-28", 241 + "additionalReferences":{ 242 + "acquirerBatchId": "fdsfsdfsd", 243 + "acquirerTransactionId" : "534313" 244 + }, 245 + "amount": 200.0 246 +} 247 +{{/code}} 248 + 249 +==== Get cash-withdrawals ==== 250 + 251 +{{code language="http" title="**Request**"}} 252 +GET /ledger/credit-account-acquiring/v1/XXX/purchases/YYY HTTP/1.1 253 +Host: - 254 +Authorization: Bearer <Token> 255 +Content-Type: application/json 256 + 257 +{{/code}} 258 + 259 +==== List cash-withdrawals ==== 260 + 261 +{{code language="http" title="**Request**"}} 262 +GET /ledger/credit-account-acquiring/v1/XXX/purchases HTTP/1.1 263 +Host: - 264 +Authorization: Bearer <Token> 265 +Content-Type: application/json 266 + 267 +{{/code}} 268 + 269 +==== Resource cash-withdrawals ==== 270 + 271 +{{code language="http" title="**Response**"}} 272 +HTTP/1.1 201 CREATED 273 +Content-Type: application/json 274 + 275 +{ 276 + "description": "stora butiken test, köpref. 12345689", 277 + "authorizationId" : "AUTH71", 278 + "sourcePurchaseTransactionId" : "534313", 279 + "sellerReceiptId": "2019-11-28", 280 + "additionalReferences":{ 281 + "acquirerBatchId": "fdsfsdfsd", 282 + "acquirerTransactionId" : "534313" 283 + }, 284 + "amount": 200.0, 285 + "corrections": "/ledger/credit-account-acquiring/v1/XXX/purchases/YYY/corrections", 286 + "@id": "/ledger/credit-account-acquiring/v1/XXX/purchases/YYY", 287 + "operations": [ 288 + { 289 + "rel": "create-correction", 290 + "method": "post", 291 + "href": "/ledger/credit-account-acquiring/v1/XXX/purchases/YYY/corrections" 292 + } 293 + ] 294 +} 295 +{{/code}} 296 + 297 +==== Resource properties purchases ==== 298 + 299 +(% class="table-bordered table-striped" %) 300 +|=(% style="width: 337px;" %)Property|=(% style="width: 121px;" %)Data type|=(% style="width: 164px;" %)Format|=(% style="width: 1156px;" %)Description 301 +|(% style="width:337px" %)@id |(% style="width:121px" %)string|(% style="width:164px" %)Uri|(% style="width:1156px" %) 302 +|(% style="width:337px" %)description|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 200|(% style="width:1156px" %)Describes the current Purchase (derives from info sent in the authorization), may be printed on the bill, output only 303 +|(% style="width:337px" %)authorizationId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 6|(% style="width:1156px" %)The id of the authorization from which this purchase originated from (not required if the purchase was made offline) 304 +|(% style="width:337px" %)((( 305 +(% style="background-color:transparent" %)sourcePurchaseTransactionId 306 +)))|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Unique identifier of the Purchase transaction 307 +|(% style="width:337px" %)((( 308 +additionalReferences.acquirerBatchId 309 +)))|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Used for reconciling acquirer transactions. See [[RKHA21>>||anchor="HRKHA21format"]] section on this page for more information 310 +|(% style="width:337px" %)additionalReferences.acquirerTransactionId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Unique acquirer identifier of the transaction 311 +|(% style="width:337px" %)sellerReceiptId|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %) 312 +|(% style="width:337px" %)amount|(% style="width:121px" %)decimal|(% style="width:164px" %) |(% style="width:1156px" %) 313 +|(% style="width:337px" %)offlineInfo.pointOfSale|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 50|(% style="width:1156px" %)Name of the location/point/shop of sale, will be returned in reservation resource 314 +|(% style="width:337px" %)offlineInfo.cardToken|(% style="width:121px" %)string|(% style="width:164px" %) |(% style="width:1156px" %)Identifier of the card. The purchase will be made on the account that the card is linked to 315 +|(% style="width:337px" %)offlineInfo.sellerNumber|(% style="width:121px" %)string|(% style="width:164px" %)Maxlength: 15|(% style="width:1156px" %)Identifier of the current seller/merchant 316 +|(% style="width:337px" %)corrections|(% style="width:121px" %)string|(% style="width:164px" %)Uri|(% style="width:1156px" %) 317 + 318 +---- 319 + 320 +=== Correction (Purchase) === 321 + 215 215 Used to reverse a Purchase transaction 216 216 217 217 ==== Create corrections ==== 218 218 219 219 {{code language="http" title="**Request**"}} 220 -POST /ledger/credit-account-acquiring/v1/XXX/ authorizations/NNN/purchases/YYY/corrections HTTP/1.1327 +POST /ledger/credit-account-acquiring/v1/XXX/purchases/YYY/corrections HTTP/1.1 221 221 Host: - 222 222 Authorization: Bearer <Token> 223 223 Content-Type: application/json ... ... @@ -227,8 +227,7 @@ 227 227 "acquirerBatchId": "fdsfsdfsd", 228 228 "acquirerTransactionId" : "534313", 229 229 }, 230 - "sellerReceiptId" : "534313", 231 - "sourceReversalTransactionId" : "534313", 337 + "sourceCorrectionTransactionId" : "534313", 232 232 "amount": 200.0 233 233 } 234 234 {{/code}} ... ... @@ -236,7 +236,7 @@ 236 236 ==== Get corrections ==== 237 237 238 238 {{code language="http" title="**Request**"}} 239 -GET /ledger/credit-account-acquiring/v1/XXX/ authorizations/NNN/purchases/YYY/corrections/NNN HTTP/1.1345 +GET /ledger/credit-account-acquiring/v1/XXX/purchases/YYY/corrections/NNN HTTP/1.1 240 240 Host: - 241 241 Authorization: Bearer <Token> 242 242 Content-Type: application/json ... ... @@ -264,10 +264,9 @@ 264 264 "acquirerBatchId": "fdsfsdfsd", 265 265 "acquirerTransactionId" : "534313", 266 266 }, 267 - "source ReversalTransactionId" : "534313",373 + "sourceCorrectionTransactionId" : "534313", 268 268 "amount": 200.00, 269 - "currency": "SEK", 270 - "@id" : "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY/credits/ZZZ", 375 + "@id" : "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY/corrections/ZZZ", 271 271 "parentHREF": "/ledger/credit-account-acquiring/v1/XXX/authorizations/NNN/purchases/YYY", 272 272 "operations" : [] 273 273 } ... ... @@ -301,17 +301,14 @@ 301 301 Content-Type: application/json 302 302 303 303 { 304 - "pointOfSale": "stora butiken test, köpref. 12345689", 305 - "cardToken" : "1564316498964156", 306 - "sellerReceiptId": "12345689", 307 - "sellerNumber" : "654", 409 + "authorizationId" : "AUTH71", 410 + "sellerReceiptId": "12345689", 308 308 "additionalReferences":{ 309 309 "acquirerBatchId": "fdsfsdfsd", 310 310 "acquirerTransactionId" : "534313", 311 311 }, 312 - "sourceRefundTransactionId" : "534312", 313 - "amount": 200.0, 314 - "currency": "SEK" 415 + "sourceReversalTransactionId" : "534312", 416 + "amount": 200.0 315 315 } 316 316 {{/code}} 317 317 ... ... @@ -342,17 +342,14 @@ 342 342 Content-Type: application/json 343 343 344 344 { 345 - "pointOfSale": "stora butiken test, köpref. 12345689", 346 - "cardToken" : "1564316498964156", 347 - "sellerReceiptId": "12345689", 348 - "sellerNumber" : "654", 447 + "authorizationId" : "AUTH71" 448 + "sellerReceiptId": "12345689", 349 349 "additionalReferences":{ 350 350 "acquirerBatchId": "fdsfsdfsd", 351 351 "acquirerTransactionId" : "534313", 352 352 }, 353 - "sourceRefundTransactionId" : "534313", 354 - "amount": 200.00, 355 - "currency": "SEK", 453 + "sourceReversalTransactionId" : "534312", 454 + "amount": 200.0, 356 356 "@id" : "/ledger/credit-account-acquiring/v1/XXX/corrections/YYY", 357 357 "parentHREF": "", 358 358 "operations" : []