BENEFICIARY: Perform Name Change

RSP can use this method to request amendment on beneficiary name. Amendment request will be based on the transaction status and corridors. For cash pickup transaction, only transaction with the payout status “In Process” or “Unclaim” is able to be amend. For banks transactions, the amendment is strictly based on the banks and country regulations.

Definition:

PUT v1/payments/transfers/{GTN}/requests/{transID}/change-name

Sample Request:

curl -v -X PUT http://staging-gloremit.tranglo.com:2014/v1/payments/transfers/G3717307424573/requests/2017110201/change-name \
-H "Content-Type: application/json \
-H "AuthorizationGLOREMIT <UID>:<PWD>:<rspSign>" \
-d '{
"beneFirstName": "Oppo",
"beneLastName": "Frank"
}'

Request Description

Parameter NameRequiredMin/Max LengthTypeRemark
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
rspSignM32/50AlphanumericDigital signature of RSP, see Section 4 for more info.
transIDC3/6AlphanumericUnique transaction ID used by RSP in Cancellation method.
GTNM3/6AlphanumericTransaction GTN number. (14 characters)
beneFirstNameM1/50AlphanumericNew beneficiary first name.
beneLastNameM1/50AlphanumericNew beneficiary last name.

Response Description

Sample Response:

{
    "TrxStatus":"946",
    "ChangeId":"null",
    "transID":"2017110201",
    "Description":"Duplicate Request"
}
Parameter NameRequiredTypeRemark
TrxStatusMNumericTransaction status response code.
(Please see Section 3.6 for full description)
ChangeIDMAlphaNumeric14-character cancellation ID.
transIDMAlphaNumericUnique Transaction ID from RSP.
DescriptionMAlphaNumericTransaction description or advice.

M= Mandatory, C= Conditional, O= Optional