Search…
Digital rights revocation
Understand how the Digital Rights Revocation service works.
The Digital Rights Revocation service is a real-time, request/response-based process used to revoke one external digital right. The service revokes a key that has already been delivered to the shopper. A key revocation integration sends a request to revoke or take back a key (serial number of unlock code) that was distributed when a product was purchased.
You can use the Digital Rights Revocation service to revoke a single previously-granted external digital right. If you need to revoke multiple digital rights for an order, you can send multiple revocation calls.
You can create a custom integration to revoke a key when:
  • A product is returned
  • An order is refunded or canceled
  • There is a chargeback, fraud, or some other failure in payment or order authorization
Digital Rights Revocation
  • Notification—Global Commerce generates a Revocation Service Request and sends the request to your endpoint.
  • Required response to notification—Your endpoint must synchronously respond with a Revocation Service Response.
Sample request
Successful response
Unsuccessful response
1
{
2
"RevocationServiceRequest": {
3
"orderInfo": {
4
"orderID": {
5
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
6
"_xsi:type": "xsd:string",
7
"__text": "123456789"
8
},
9
"externalReferenceID": {
10
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
11
"_xsi:type": "xsd:string",
12
"_xsi:nil": "true"
13
},
14
"siteID": {
15
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
16
"_xsi:type": "xsd:string",
17
"__text": "siteID"
18
},
19
"userKey": {
20
"userID": {
21
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
22
"_xsi:type": "xsd:string",
23
"__text": "213456789"
24
},
25
"externalReferenceID": {
26
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
27
"_xsi:type": "xsd:string",
28
"__text": "312456789"
29
},
30
"companyID": {
31
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
32
"_xsi:type": "xsd:string",
33
"__text": "412356789"
34
},
35
"loginID": {
36
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
37
"_xsi:type": "xsd:string",
38
"__text": "[email protected]"
39
},
40
"siteID": {
41
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
42
"_xsi:type": "xsd:string",
43
"__text": "siteID"
44
},
45
"_xmlns:ns2": "http://integration.digitalriver.com/Common/1.0",
46
"_xsi:type": "ns2:UserKey"
47
},
48
"paymentInfo": {
49
"accountID": {
50
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
51
"_xsi:type": "xsd:string",
52
"_xsi:nil": "true"
53
},
54
"authorizationID": {
55
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
56
"_xsi:type": "xsd:string",
57
"__text": "512346789"
58
},
59
"cardType": {
60
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
61
"_xsi:type": "xsd:string",
62
"__text": "CardType"
63
},
64
"customerEmail": {
65
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
66
"_xsi:type": "xsd:string",
67
"__text": "[email protected]"
68
},
69
"cardNumber": {
70
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
71
"_xsi:type": "xsd:string",
72
"__text": "6123456789"
73
},
74
"cardExpirationMonth": {
75
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
76
"_xsi:type": "xsd:string",
77
"__text": "01"
78
},
79
"cardExpirationYear": {
80
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
81
"_xsi:type": "xsd:string",
82
"__text": "2080"
83
},
84
"customerPO": {
85
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
86
"_xsi:type": "xsd:string",
87
"_xsi:nil": "true"
88
},
89
"ccIssueCode": {
90
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
91
"_xsi:type": "xsd:string",
92
"_xsi:nil": "true"
93
},
94
"ccIssueMonth": {
95
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
96
"_xsi:type": "xsd:string",
97
"_xsi:nil": "true"
98
},
99
"ccIssueYear": {
100
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
101
"_xsi:type": "xsd:string",
102
"_xsi:nil": "true"
103
},
104
"securityIndicator": {
105
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
106
"_xsi:type": "xsd:string",
107
"_xsi:nil": "true"
108
},
109
"routingNumber": {
110
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
111
"_xsi:type": "xsd:string",
112
"_xsi:nil": "true"
113
},
114
"vatNumber": {
115
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
116
"_xsi:type": "xsd:string",
117
"_xsi:nil": "true"
118
},
119
"customerLastName": {
120
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
121
"_xsi:type": "xsd:string",
122
"__text": "LastName"
123
},
124
"customerFirstName": {
125
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
126
"_xsi:type": "xsd:string",
127
"__text": "FirstName"
128
},
129
"paymentAmount": {
130
"currencyCode": {
131
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
132
"_xsi:type": "xsd:string",
133
"__text": "USD"
134
},
135
"amount": {
136
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
137
"_xsi:type": "xsd:decimal",
138
"__text": "11.11"
139
},
140
"_xmlns:ns4": "http://integration.digitalriver.com/Common/1.0",
141
"_xsi:type": "ns4:MoneyInfo"
142
},
143
"paymentMethodName": {
144
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
145
"_xsi:type": "xsd:string",
146
"__text": "paymentMethod"
147
},
148
"billingAddress": {
149
"addressID": {
150
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
151
"_xsi:type": "xsd:string",
152
"__text": "712345689"
153
},
154
"city": {
155
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
156
"_xsi:type": "xsd:string",
157
"__text": "City"
158
},
159
"countryA2": {
160
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
161
"_xsi:type": "xsd:string",
162
"_xsi:nil": "true"
163
},
164
"country": {
165
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
166
"_xsi:type": "xsd:string",
167
"__text": "US"
168
},
169
"countryName": {
170
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
171
"_xsi:type": "xsd:string",
172
"__text": "United States"
173
},
174
"line1": {
175
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
176
"_xsi:type": "xsd:string",
177
"__text": "123 Example Street"
178
},
179
"line2": {
180
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
181
"_xsi:type": "xsd:string",
182
"_xsi:nil": "true"
183
},
184
"line3": {
185
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
186
"_xsi:type": "xsd:string",
187
"_xsi:nil": "true"
188
},
189
"locationCode": {
190
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
191
"_xsi:type": "xsd:string",
192
"_xsi:nil": "true"
193
},
194
"name1": {
195
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
196
"_xsi:type": "xsd:string",
197
"__text": "FirstName"
198
},
199
"name2": {
200
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
201
"_xsi:type": "xsd:string",
202
"__text": "LastName"
203
},
204
"phoneNumber": {
205
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
206
"_xsi:type": "xsd:string",
207
"__text": "(123) 456-7890"
208
},
209
"postalCode": {
210
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
211
"_xsi:type": "xsd:string",
212
"__text": "12345"
213
},
214
"state": {
215
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
216
"_xsi:type": "xsd:string",
217
"_xsi:nil": "true"
218
},
219
"email": {
220
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
221
"_xsi:type": "xsd:string",
222
"__text": "[email protected]"
223
},
224
"faxPhone": {
225
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
226
"_xsi:type": "xsd:string",
227
"_xsi:nil": "true"
228
},
229
"companyName": {
230
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
231
"_xsi:type": "xsd:string",
232
"__text": "companyName"
233
},
234
"phoneNumber2": {
235
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
236
"_xsi:type": "xsd:string",
237
"_xsi:nil": "true"
238
},
239
"countyName": {
240
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
241
"_xsi:type": "xsd:string",
242
"_xsi:nil": "true"
243
},
244
"extendedAttributes": {
245
"_xsi:type": "ns5:ExtendedAttributesInfoArray"
246
},
247
"_xmlns:ns5": "http://integration.digitalriver.com/Common/1.0",
248
"_xsi:type": "ns5:AddressInfo"
249
},
250
"extendedAttributes": {
251
"item": {
252
"name": {
253
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
254
"_xsi:type": "xsd:string",
255
"__text": "extendedAttributeName"
256
},
257
"value": {
258
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
259
"_xsi:type": "xsd:string",
260
"__text": "value"
261
},
262
"valueDataType": {
263
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
264
"_xsi:type": "xsd:string",
265
"__text": "string"
266
},
267
"_xsi:type": "ns6:ExtendedAttributesInfo"
268
},
269
"_xmlns:ns6": "http://integration.digitalriver.com/Common/1.0",
270
"_xsi:type": "ns6:ExtendedAttributesInfoArray"
271
},
272
"_xmlns:ns3": "http://integration.digitalriver.com/commonRequisition/1.0",
273
"_xsi:type": "ns3:PaymentInformationInfo"
274
},
275
"extendedAttributes": {
276
"item": {
277
"name": {
278
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
279
"_xsi:type": "xsd:string",
280
"__text": "extendedAttributeName"
281
},
282
"value": {
283
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
284
"_xsi:type": "xsd:string",
285
"__text": "value"
286
},
287
"valueDataType": {
288
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
289
"_xsi:type": "xsd:string",
290
"__text": "string"
291
},
292
"_xsi:type": "ns7:ExtendedAttributesInfo"
293
},
294
"_xmlns:ns7": "http://integration.digitalriver.com/Common/1.0",
295
"_xsi:type": "ns7:ExtendedAttributesInfoArray"
296
},
297
"_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
298
"_xsi:type": "ns1:OrderInfo"
299
},
300
"lineItemInfo": {
301
"lineItemID": {
302
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
303
"_xsi:type": "xsd:string",
304
"__text": "812345679"
305
},
306
"productInfo": {
307
"productKey": {
308
"productID": {
309
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
310
"_xsi:type": "xsd:string",
311
"__text": "912345678"
312
},
313
"externalReferenceID": {
314
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
315
"_xsi:type": "xsd:string",
316
"__text": "012345678"
317
},
318
"companyID": {
319
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
320
"_xsi:type": "xsd:string",
321
"__text": "102345678"
322
},
323
"locale": {
324
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
325
"_xsi:type": "xsd:string",
326
"_xsi:nil": "true"
327
},
328
"_xmlns:ns8": "http://integration.digitalriver.com/Common/1.0",
329
"_xsi:type": "ns8:ProductKey"
330
},
331
"digitalRight": {
332
"key": {
333
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
334
"_xsi:type": "xsd:string",
335
"__text": "key"
336
},
337
"keyType": {
338
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
339
"_xsi:type": "xsd:string",
340
"__text": "KEY_TYPE"
341
},
342
"lineItemQuantityID": {
343
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
344
"_xsi:type": "xsd:int",
345
"__text": "1"
346
},
347
"_xsi:type": "ns1:DigitalRightInfo"
348
},
349
"productAttributes": {
350
"item": {
351
"name": {
352
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
353
"_xsi:type": "xsd:string",
354
"__text": "ExtendedAttributeName"
355
},
356
"value": {
357
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
358
"_xsi:type": "xsd:string",
359
"__text": "value"
360
},
361
"valueDataType": {
362
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
363
"_xsi:type": "xsd:string",
364
"__text": "string"
365
},
366
"_xsi:type": "ns9:ExtendedAttributesInfo"
367
},
368
"_xmlns:ns9": "http://integration.digitalriver.com/Common/1.0",
369
"_xsi:type": "ns9:ExtendedAttributesInfoArray"
370
},
371
"_xsi:type": "ns1:ProductInfo"
372
},
373
"extendedAttributes": {
374
"_xmlns:ns11": "http://integration.digitalriver.com/Common/1.0",
375
"_xsi:type": "ns11:ExtendedAttributesInfoArray"
376
},
377
"_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
378
"_xsi:type": "ns1:LineItemInfo"
379
},
380
"revocationReason": {
381
"_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
382
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
383
"_xsi:type": "xsd:string",
384
"__text": "Return-Product"
385
},
386
"revocationInfo": {
387
"disputeInfo": {
388
"_xsi:type": "ns1:DisputeRevocationInfo",
389
"_xsi:nil": "true"
390
},
391
"suppressionInfo": {
392
"_xsi:type": "ns1:SuppressionRevocationInfo",
393
"_xsi:nil": "true"
394
},
395
"returnInfo": {
396
"returnID": {
397
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
398
"_xsi:type": "xsd:string",
399
"__text": "2013456789"
400
},
401
"returnLineItemID": {
402
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
403
"_xsi:type": "xsd:string",
404
"__text": "301245789"
405
},
406
"returnDate": {
407
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
408
"_xsi:type": "xsd:dateTime",
409
"__text": "2014-09-14T12:00:32.212Z"
410
},
411
"returnReason": {
412
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
413
"_xsi:type": "xsd:string",
414
"__text": "RETURN_REASON"
415
},
416
"returnTotalAmount": {
417
"currencyCode": {
418
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
419
"_xsi:type": "xsd:string",
420
"__text": "USD"
421
},
422
"amount": {
423
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
424
"_xsi:type": "xsd:decimal",
425
"__text": "11.11"
426
},
427
"_xmlns:ns12": "http://integration.digitalriver.com/Common/1.0",
428
"_xsi:type": "ns12:MoneyInfo"
429
},
430
"returnSubtotalAmount": {
431
"currencyCode": {
432
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
433
"_xsi:type": "xsd:string",
434
"__text": "USD"
435
},
436
"amount": {
437
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
438
"_xsi:type": "xsd:decimal",
439
"__text": "11.11"
440
},
441
"_xmlns:ns13": "http://integration.digitalriver.com/Common/1.0",
442
"_xsi:type": "ns13:MoneyInfo"
443
},
444
"returnTaxAmount": {
445
"currencyCode": {
446
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
447
"_xsi:type": "xsd:string",
448
"__text": "USD"
449
},
450
"amount": {
451
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
452
"_xsi:type": "xsd:decimal",
453
"__text": "0.00"
454
},
455
"_xmlns:ns14": "http://integration.digitalriver.com/Common/1.0",
456
"_xsi:type": "ns14:MoneyInfo"
457
},
458
"returnFeesAmount": {
459
"_xmlns:ns17": "http://integration.digitalriver.com/Common/1.0",
460
"_xsi:type": "ns17:MoneyInfo",
461
"_xsi:nil": "true"
462
},
463
"returnShippingAmount": {
464
"currencyCode": {
465
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
466
"_xsi:type": "xsd:string",
467
"__text": "USD"
468
},
469
"amount": {
470
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
471
"_xsi:type": "xsd:decimal",
472
"__text": "0.00"
473
},
474
"_xmlns:ns18": "http://integration.digitalriver.com/Common/1.0",
475
"_xsi:type": "ns18:MoneyInfo"
476
},
477
"returnLineItemTotalAmount": {
478
"currencyCode": {
479
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
480
"_xsi:type": "xsd:string",
481
"__text": "USD"
482
},
483
"amount": {
484
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
485
"_xsi:type": "xsd:decimal",
486
"__text": "11.11"
487
},
488
"_xmlns:ns19": "http://integration.digitalriver.com/Common/1.0",
489
"_xsi:type": "ns19:MoneyInfo"
490
},
491
"returnLineItemSubtotalAmount": {
492
"currencyCode": {
493
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
494
"_xsi:type": "xsd:string",
495
"__text": "USD"
496
},
497
"amount": {
498
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
499
"_xsi:type": "xsd:decimal",
500
"__text": "11.11"
501
},
502
"_xmlns:ns20": "http://integration.digitalriver.com/Common/1.0",
503
"_xsi:type": "ns20:MoneyInfo"
504
},
505
"returnLineItemTaxAmount": {
506
"currencyCode": {
507
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
508
"_xsi:type": "xsd:string",
509
"__text": "USD"
510
},
511
"amount": {
512
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
513
"_xsi:type": "xsd:decimal",
514
"__text": "0.00"
515
},
516
"_xmlns:ns21": "http://integration.digitalriver.com/Common/1.0",
517
"_xsi:type": "ns21:MoneyInfo"
518
},
519
"returnLineItemShippingAmount": {
520
"currencyCode": {
521
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
522
"_xsi:type": "xsd:string",
523
"__text": "USD"
524
},
525
"amount": {
526
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
527
"_xsi:type": "xsd:decimal",
528
"__text": "0.00"
529
},
530
"_xmlns:ns24": "http://integration.digitalriver.com/Common/1.0",
531
"_xsi:type": "ns24:MoneyInfo"
532
},
533
"returnLineItemQuantity": {
534
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
535
"_xsi:type": "xsd:int",
536
"__text": "1"
537
},
538
"satisfaction": {
539
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
540
"_xsi:type": "xsd:boolean",
541
"__text": "false"
542
},
543
"_xsi:type": "ns1:ReturnRevocationInfo"
544
},
545
"_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
546
"_xsi:type": "ns1:RevocationInfo"
547
},
548
"_xmlns:ns1": "http://integration.digitalriver.com/RevocationService",
549
"__prefix": "ns1"
550
}
551
}
Copied!
1
{
2
"RevocationServiceResponse": {
3
"successful": "success",
4
"isAutoRetriable": "false",
5
"responseCode": "1234",
6
"responseType": "responseType",
7
"responseMessage": "SUCCESS"
8
}
9
}
Copied!
1
{
2
"RevocationServiceResponse": {
3
"successful": "success",
4
"isAutoRetriable": "false",
5
"responseCode": "1234",
6
"responseType": "responseType",
7
"responseMessage": "SUCCESS"
8
}
9
}
Copied!

Revocation reason table

Revocation Reason
Description
DisputeLineitem
The Line Item that contains the Digital Right is under dispute.
DisputeAmount
A non-Line-Item-specific amount on the requisition is under dispute (for example, the client disputes $30.00 because they were unhappy with something).
FraudSuppression
The requisition containing the Digital Right was suppressed.
ReturnProduct
ReturnProduct
ReturnSatisfaction
The Line Item containing the Digital Right underwent a satisfaction refund (the product was not returned).
DeclinedSettlement
The Settlement Payment Transaction was declined.
PreLoadCancel
The preload Line Item was canceled and has not been released.

Schemas

Version
Schema Components Table
Raw Schema
Sample XML
6 (Current)
View
View
View
5
View
View
View
4
View
View
View
Last modified 1yr ago